Calhoun 

Imti'uliOMl  Archive  ■of  dw  NavJl  PostguduiHe  School 


Calhoun:  The  NPS  Institutional  Archive 
DSpace  Repository 


Theses  and  Dissertations 


Thesis  and  Dissertation  Collection 


1976 

The  design  of  a  user  interface  for  a  color, 
raster  scan  graphics  device. 

Nesslage,  Roger  Lee 

Monterey,  California.  Naval  Postgraduate  School 


http://hdl.handle.net/10945/17724 


Downloaded  from  NPS  Archive:  Calhoun 


DUDLEY 

KNOX 

LIBRARY 


Calhoun  is  a  project  of  the  Dudley  Knox  Library  at  NPS,  furthering  the  precepts  and 
goals  of  open  government  and  government  transparency.  All  information  contained 
herein  has  been  approved  for  release  by  the  NPS  Public  Affairs  Officer. 

Dudley  Knox  Library  /  Naval  Postgraduate  School 
411  Dyer  Road  /  1  University  Circle 
Monterey,  California  USA  93943 


http  ://w  w  w.  nps.edu/lEbrary 


the  design  of  a  user  interface 

FOR  A 

COLOR,  RASTER  SCAN  GRAPHICS  DEVICE 


Roger  Lee  Ness! age 


NAVAL  POSTGRADUATE  SCHOOL 

Monterey,  California 


THESIS 


THE  DESIGN  OF  A  USER  INTERFACE 

FOR  A 

COLOR,  RASTER  SCAN  GRAPHICS  DEVICE 

by 

Roger  Lee  Nesslage 

June  1976 

Thesis  Advisor: 

G.  M.  Raetz 

Approved  for  public  release;  distribution  unlimited. 

T 174142 


SECURITY  CLASSIFICATION  OF  THIS  PA GE  (Whmn  Dmtm  Sntmrmd) 


REPORT  DOCUMENTATION  PAGE 

READ  INSTRUCTIONS 

BEFORE  COMPLETING  FORM 

lreport  number 

2.  GOVT  ACCESSION  NO. 

3.  RECIPIENT'S  CATALOG  NUMBER 

A.  TITLE  (mid  Submit) 

The  Design  of  a  User  Interface  for  a 
Color,  Raster  Scan  Graphics  Device 

5.  TYPE  OF  REPORT  A  PERIOO  COVEREO 

Master's  Thesis; 

June  1976 

8.  PERFORMING  ORG.  REPORT  NUMBER 

7.  AUTHOR^; 

•  .  CONTRACT  OR  GRANT  NliMlERfi; 

Roger  Lee  Nesslage 

».  PERFORMING  ORGANIZATION  NAME  ANO  AOORESS 

Naval  Postgraduate  School 

Monterey,  California  93940 

10.  PROGRAM  ELEMENT.  PROJECT,  TASK 

AREA  A  WORK  UNIT  NUMBERS 

1  1.  CONTROLLING  OFFICE  NAME  ANO  AOORESS 

Naval  Postgraduate  School 

Monterey,  Californi  £  93940 

12.  REPORT  OATE 

June  1976 

13.  NUMBER  OF  PAGES 

98 

U.  MONITORING  AGENCY  NAME  A  AOORE SS(H  dUimrmnt  /root  Controlling  Otilcm) 

15.  SECURITY  CLASS,  (ol  thim  riRort; 

Naval  Postgraduate  School 
Monterey,  California  93940 

Unclassified 

I5«.  OECL  ASSI  F|  CATION/ DOWNGRADING 

SCHEOULE 

16.  DISTRIBUTION  STATEMENT  (oi  thim  Rmpott) 

Approved  for  public  release; 

distribution 

unlimited . 

17.  DISTRIBUTION  STATEMENT  (oi  thm  mbmtrmct  mntmrmd  In  Block  20,  If  dllfmrmnt  from  Rmport) 

18.  SUPPLEMENTARY  NOTES 

19.  KEY  WORDS  (Contlnum  on  rmwmxmm  ml  dm  If  nmcmmmmry  *nd  Idmntity  by  block  numbmr) 

Graphics 

Color 

User- Interf  ace 

Raster 

RAMTEK 

20.  ABSTRACT  ('Con/lnuo  on  rmwmcmm  ml  dm  If  n  mcmmmmry  mnd  Idmntity  by  block  mmtbmc) 

This  thesis  is  a  summary  of  the  design  and  implementation  of 
a  user  interface  for  a  color,  raster-scan  graphics  display 
device.  The  problems,  solutions  and  a  general  set  of  guidelines 
related  to  designing  an  interface  for  a  color  capable  graphics 
device  are  discussed.  The  implementation  of  a  software  inter¬ 
face  for  a  RAMTEK  GX-100A  with  the  PDP-11/50  computer  is  pre¬ 
sented.  The  interface  is  implemented  within  the  conventions  of 

DD  |  janM73  1  473  EDITION  OF  I  MOV  5i  IS  OlSOLETC 
(Page  1)  S/N  0102-014*  6601  | 


SECURITY  CLASSIFICATION  OF  THIS  PAGE  (Whmn  Dmtm  Mntmemd) 

1 


fliCUWtTV  CLASSIFICATION  of  This  P*GE^#n  0«.f«  Ertfrmd- 


20.  (cont.) 


the  C  programming  language  and  executes  under  the  UNIX 
operating  system.  Recommendations  for  further  expansion 
of  the  interface  are  discussed. 


DD  Form  1473 
1  Jan  73 

S/N  0102-014-6601 


security  classification  of  this  pace «*<•<••<« 


2 


The  Oes i gn 
Color,  Raster 


of  a  User  Interface 
for  a 

Scan  Graphics  Device 


by 


Roger  Lee  J^esslage 

First  Lieutenant  »  Unitea  States  Marine  Corps 
8.  A.,  C u 1 ve r-S t oc k t on  College/  1971 


Submitted  in  partial  fulfillment  of  the 
requirements  for  the  degree  of 


MASTER  OF  SCIENCE  IN  COMPUTER  SCIENCE 


from  the 

NAVAL  POSTGRADUATE  SCHOOL 
JUNE,  1976 


I 


DUDLEY  KNOX  LIBRARY 
saval  postgraduate  schca- 

roNXEBEY,  CALIFORNIA  »»« 


ABSTRACT 
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This  thesis  is  a  summary  of  the  design  and  implementa¬ 
tion  of  a  user  interface  for  a  color,  raster-scan  graphics 
display  device.  The  problems,  solutions  and  a  general  set 
of  guidelines  related  to  desianina  an  interface  for  a  color 
capable  graphics  device  are  discussed.  The  implementation 
of  a  software  interface  for  a  RA^TEK  G  X  - 1 0  0  A  with  the 
PDP-tl/50  computer  is  presented.  The  interface  is  imple¬ 
mented  within  the  conventions  of  the  C  programming  language 
and  executes  under  the  UNIX  operating  system.  Recommenda¬ 
tions  for  further  expansion  of  the  interface  are  di scusseo. 


a 


TABLE  OF  CONTENTS 


I.  INTRODUCTION .  9 

II.  GENERAL  DESCRIPTION  OF  RASTER  SCAN  DEVICES .  10 

III.  THE  R A M T E K  GX-100A  GRAPHICS  DISPLAY .  12 

A.  BI-DIRECTIONAL  INTERFACE .  12 

B.  DEVICE  MULTIPLEXOR .  12 

C.  DISPLAY  GENERATOR .  14 

D.  MEMORY .  14 

E.  VIDEO  GENERATOR .  15 

F.  VIDEO  LOOKUP  TABLE .  15 

IV.  POSITIONAL  ADDRESSING .  17 

A.  ABSOLUTE  ADDRESSING .  17 

B.  INDEXED  ADDRESSING . 17 

C.  RELATIVE  ADDRESSING .  18 

V.  CONTROL  MODES .  18 

VI.  SPECIAL  FUNCTIONS... .  20 

VII.  GENERAL  USER  INTERFACE  DESIGN .  21 

A.  MULTILEVEL  STRUCTURE .  21 

1.  Level  I  -  Primitive  Hardware  Oriented 

Subroutines .  22 

2.  Level  II  -  Complex  Information  Handling 

Subroutines .  22 

3.  Level  III  -  Generalized  User  Oriented 

Sub rou t  ines . 22 

4.  Level  TV  -  Aoplication  Language 

P roc  essors .  22 

VIII.  USER  INTERFACE  DESIGN  FOR  THE  RAMTEK  GX100-A .  23 

A.  GENERAL .  23 

1.  Primitive  Functions . 25 


5 


B.  APPLICATION  OF  COLOR .  25 

1.  Interactive  Program .  26 

a.  Se  1  f -Tu  t  o  r  i  a  1 .  26 

b.  Color  Table  Design .  26 

c.  Multiple  Edit  Modes . 26 

2 .  Color  Cube .  27 

C.  VIRTUAL  DISPLAY  SCREEN .  27 

D.  HIGH  LEVEL  GRAPHIC  TOOLS .  29 

E.  INPUT  AND  OUTPUT  ROUTINES .  29 

F.  MAINTAINABILITY .  30 

IX.  RECOMMENDATIONS .  30 

A.  USER  INTERFACE  ADDITIONS .  30 

B.  ADDITION  OF  HIGHER  LEVEL  USER  ROUTINES .  31 

X.  CONCLUSIONS .  31 

APPENDIX  A:  USER  MANUAL .  32 

APPENDIX  B:  USER  INTERFACE  ROUTINE  DESCRIPTIONS .  61 

LIST  OF  REFERENCES .  97 

INITIAL  DISTRIBUTION  LIST .  R9 


6 


LIST  OF  FIGURES 


Figure  1:  Line/  Element/  Pixel  Relationship .  11 

Figure  2  :  RAMTEK  Hardware  Configuration .  13 

Figure  3:  Memory  Configuration . . .  15 

Figure  4:  Video  Lookup  Table*. . 16 

Figure  5:  Color  Cube .  28 

Figure  A-l:  User  Interface/  RAMTEK  Relationship.......  33 

Figure  A  -  2  :  RAMTEK  Character  Font . 38 

Figure  A  -  3  :  Effect  of  Additive  Write  Flag 

in  Alphanumeric  M0de. . 41 

Figure  A-4;  Effect  of  Double  Width  Flag 

in  Alphanumeric  Mode.. . 42 

Figure  A-5:  Transverse  Data  Processing....... .  43 

Figure  A-6:  Effect  of  Reverse  Background  and 

Double  Width  Flag  on  Transverse  Data......  4a 

Figure  A  -  7  :  Raster  Data  Processing .  45 

Figure  A-8:  Complex  Data  Process!  na.  .  .  . . 46 

Figure  A  -  9  :  Drawing  Vectors  in  Graphic  Vector  Mode....  47 

Figure  A-10:  Drawinq  Vectors  with  Fixooint  Flag .  48 

Figure  A  -  1  1  :  Plotting  Methods . 49 

Figure  A-12:  Drawing  Rectanales  With  and  without 

Fixpoint  Flag . 50 

Figure  A-13:  Color  Lookup  Table  Entry  Format .  52 


7 


LIST  OF  TABLES 


table 

I : 

CONTROL 

MODE  DEFINITIONS . . 

TABLE 

1 1 : 

CONTROL 

FLAG  DEFINITIONS . . 

TABLE 

A  - 1 : 

CONTROL 

MODES  AND  CONTROL  FLAGS . . 

TABLE 

A  - 1 1 : 

RESERVED 

WORDS . . 

8 
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INTRODUCTION 


This  thesis  is  the  design  and  implementation  of  a  user 
interface  for  a  color,  raster-scan  display  device,  specifi¬ 
cally  the  RAMTEK  GX-100A.  The  basic  design  and  operation  of 
the  device  as  imolemented  in  the  Naval  Postgraduate  School 
Computer  Laboratory  is  discussed. 

The  actual  design  and  operation  of  the  interface  is 
presented  as  well  as  the  orobl ems  which  were  considered  in 
its  design  and  construction.  The  main  consideration  in  the 
design  of  the  interface  was  how  to  effectively  imolement  the 
use  of  color  in  a  graphic  disolay. 

The  concept  of  a  color  triole  and  color  cube  are  intro¬ 
duced  as  natural  extensions  of  the  method  used  by  color 
graphics  devices.  However,  the  triple  and  cube  are  strictly 
defined  by  limitations  in  the  hardware  that  restrict  the 
number  of  colors  that  can  be  generated  to  4096. 

A  user's  manual  was  written  to  enable  the  user  to  util¬ 
ize  the  interface  from  a  program  written  in  the  high  level 
language,  C  Ill,  supported  by  the  UNIX  operating  system  on 
the  PDP-11/50.  It  is  included  in  Appendix  A. 
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II.  general  description  of  raster  scan  devices 


The  cathode  ray  tube  is  the  most  widely  used  graphics 
display  device  today.  It  consists  basically  of  an  electron 
gun  which  projects  a  beam  of  electrons  onto  a  screen  which 
has  a  phosohor  coating.  The  phosphor  is  excited  when  struck 
by  the  beam  of  electrons  and  emits  visible  light  which  is 
perceived  by  the  viewer.  Due  to  the  short  persistence  of 
the  phosphor  utilized  on  most  cathode  ray  tubes,  it  is 
necessary  to  reoeatedly  excite  it  to  minimize  fading  of  the 
image  and  reduce  visible  flicker.  There  are  two  basic 
methods  used  to  refresh  a  display.  The  first  is  to  directly 
trace  the  image  beina  produced  several  times  a  second  with 
the  electron  beam  turned  on.  The  second  is  to  scan  the 
entire  screen  with  the  beam,  while  only  turning  the  beam  on 
and  off  when  desired  to  produce  the  image.  The  second  is 
known  as  the  raster  scan  technique.  It  is  the  same  teen- 
nique  used  in  commercial  television  sets. 

In  raster  scan  devices,  the  screen  is  divided  into  lines 
and  elements.  Lines  extend  horizontally  across  the  screen 
and  elements  are  discrete  positions  on  a  line.  A  specific 
element  on  a  specific  line  is  called  a  pixel.  Figure  1 
illustrates  the  relationship  of  lines,  pixels  and  elements 
to  each  other  and  the  screen.  The  number  of  pixels  deter¬ 
mines  the  resolution  of  the  screen.  The  more  pixels,  the 
higher  the  resolution  of  the  picture* 


10 


ELEMENTS 


Line/  Element/  Pixel  Relationship 
Figure  1 


The  added  feature  of  color  in  a  raster  scan  device  re¬ 
quires  the  addition  of  two  more  electron  guns  and  a  more 
complicated  phosphor  coating  on  the  screen.  The  phosphors/ 
representing  the  primary  colors  of  blue/  green  and  red  are 
located  in  each  pixel  area  and  are  called  a  triad.  The 
three  guns  are  used  to  produce  three  electron  beams  to  scan 
the  screen.  These  beams  are  independently  varied  in  intensi¬ 
ty  to  excite  any  one/  two  or  three  phosphors  to  produce  the 
desired  color. 

In  order  for  an  image  to  be  drawn  in  color/  not  only 
must  the  electron  guns  be  turned  on  and  off  at  the  orooer 
locations/  out  the  combination  of  beams  and  the  intensity  of 


each  must  be  adjusted  to  oroduce  the  color 


III.  THE  RAMTEK  GX-100A  GRAPHICS  DISPLAY 

The  RAMTEK  is  an  interactive/  raster-scan/  color  graph¬ 
ics  display  device.  It  consists  of  a  bi-directional  inter¬ 
face/  a  display  generator/  solid  state  memory/  a  video  look¬ 
up  table/  device  multiplexor/  keyboard/  cursor  generator/ 
video  generator/  and  a  cathode  ray  tube  123  .  Figure  2  il¬ 
lustrates  the  relationship  of  the  hardware  and  the  component 
parts'  relationships  with  each  other. 

A.  BI-DIRECTIONAL  INTERFACE 

The  bi-directional  interface  connects  the  PDP-11  with 
the  video  lookup  table/  display  generator  and  the  device 
multiplexor.  The  interface  establishes  data  paths  to  and 
from  the  CPU  and  the  device  multiplexor/  the  video  lookuo 
table/  and  the  display  generator. 

B.  DEVICE  MULTIPLEXOR 

The  device  multiolexor  interconnects  with  the  cursor 
generator  and  the  keyboard.  It  enables  the  CPU  to  receive 
data  via  the  RAMTEK  keyboard. 

The  keyboard  converts  the  keystrokes  into  extended  ASCII 
character  codes  which  are  transmitted  to  the  device  multi¬ 
plexor. 

/ 
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RAMTEK  Hardware  Configuration 
Figure  2 
1  3 


C,  DISPLAY  GENERATOR 


The  display  generator  contains  the  standard  ASCII  char¬ 
acter  codes  and  hardware  logic  such  that  dot-matrix  charac¬ 
ter  patterns  are  generated  and  passed  to  the  memory.  It 
also  takes  input  data  and  processes  it  according  to  the 
instructions"  receiveo  and  writes  the  aporoor i ate  data  into 
the  memory  so  the  proper  image  will  be  displayed. 

D.  MEMORY 

The  organization  of  the  solid  state  refresh  memory  is 
the  kev  to  the  operation  of  the  R  A  M  T  E  K  .  The  memory  consists 
of  up  to  eight  memory  boards  (planes)  which  have  the  capaci¬ 
ty  to  store  512  lines  by  640  elements.  The  R A M T E K  used  in 
this  work  has  four  memory  olanes  and  an  effective  address 
space  of  240  lines  by  640  elements. 

As  illustrated  by  figure  3/  the  memory  can  be  viewed  as 
a  three  dimensional  structure  with  the  x-axis  corresponding 
to  the  elements,  the  y-axis  corresoondi na  to  the  lines  and 
the  z-axis  corresponding  to  the  display  subchannels. 

The  displav  subchannels  represent  a  binary  pointer  into 
the  video  lookup  table  by  only  oermitting  certain  planes  of 
memory  to  be  written  in.  Thus  the  binary  code  on  a  certain 
z-axis  represents  the  pointer  into  the  video  lookup  table. 
This  establishes  the  color  to  be  displayed  at  that  location 
on  the  screen.  For  example,  if  the  z-axis  at  line  five, 
element  56  contains  a  0101,  the  pointer  into  the  video  look¬ 
up  table  points  to  entry  five. 
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Memory  Configuration 

Figure  3 

E  ,  VIDEO  GENERATOR 

The  video  generator  reads  the  information  stored  in  the 
refresh  memory  and  generates  the  comoatable  signals  for  the 
cathode  ray  tube  (CRT)  to  disolay  the  image  on  the  screen, 

F.  VIDEO  LOOKUP  TABLE 

The  video  1 ookuo  table  is  the  center  of  the  color  gen¬ 
erating  caoability  of  the  R  A  M T  E  K  ,  It  contains  sixteen  arbi¬ 
trary  colors  from  address  zero  to  fifteen  in  the  table.  As 
described  aoovej  the  combination  of  memory  olanes  enabled 
by  the  selected  subchannels  reoresents  the  pointer  to  an 
entry  in  the  video  lookuo  table.  Each  entry  in  the  video 
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lookup  table  consists  of  a  twelve-bit  code  broken  into  three 
four-bit  binary  fractions  which  corresoond  to  intensities 
of  blue/  green  and  red.  As  illustrated  in  figure  4  /  bits 
zero  through  three  represent  red/  four  through  seven 
represent  green  and  eight  through  eleven  represent  blue. 
Therefore/  any  of  ^096  colors  can  be  represented  in  the 
twelve  bits.  Only  sixteen  colors  can  be  diSDlayed  on  the 
screen  at  any  one  time  because  having  four  planes  of  memory 
to  represent  the  oointer  to  the  video  lookup  table  limits 
the  pointer  value  to  zero  through  fifteen. 


Video  Lookup  Table 
Fiaure  4 
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IV  .  positional  addressing 


There  are  three  methods  of  address i n a  the  RAMTEK  screen; 
absolute^  indexed  and  relative.  As  stated  earlier,  address¬ 
ing  a  raster  scan  device  is  accomplished  by  specifinq  the 
line  and  element  number  which  indicate  the  address  of  a 
pixel  on  the  screen. 

Because  of  the  low  line  resolution  of  the  device  used, 
only  even  lines  are  aadressabl e.  Therefore  the  line  ad¬ 
dressing  is  from  zero  to  480  where  zero  and  one  address  the 
same  line,  two  and  three  address  the  same  line  and  so  on. 
The  address  that  is  currently  being  referred  to  is  known  as 
the  current  operating  ooint  (COP).  It  is  like  a  oointer  to 
a  location  on  the  screen  where  the  next  entity  will  be 
d  i  s  p  1  a  y  e  d  . 

A .  ABSOLUTE  ADDRESSING 

By  specifying  a  line  and  element  number,  a  single  pixel 
is  addressed  in  the  same  way  as  a  point  is  addressed  in  a 
cartesian  coordinate  system.  The  COP  is  at  that  pixel. 

B.  INDEXED  ADDRESSING 

The  RAMTEK  provides  two  index  regi sters  which  can  be 
used  in  addressing  the  RAMTEK  screen.  To  address  a  location 
usinq  index  registers,  the  specified  line  and  element 
numbers  are  summed  with  the  contents  of  the  line  and  element 
index  registers  to  yield  the  address  of  a  oixel  on  the 
screen.  For  example,  if  the  specified  address  is  line  100, 
element  POO  and  the  line  and  element  index  registers  contain 
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26  and  30  resoect i vel y#  tHe  resulting  address  (COP)  is  line 
126/  el emen t  130. 

C.  RELATIVE  ADDRESSING 

This  method  takes  the  specified  line  and  element  numbers 
and  considers  them  to  be  displacements#  that  is#  the  number 
of  lines  and  elements  to  add  to  the  COP  address  to  yield  a 
new  COP.  For  example#  if  the  specified  displacements  are  20 
lines  and  30  elements#  and  the  COP  is  line  100#  element  M0; 
the  new  COP  is  line  120#  element  170. 

V.  CONTROL  MODES 

The  RAMTEK  operates  in  any  one  of  eight  control  modes 
(2).  Each  control  moae  can  be  modified  by  selected  control 
flags*  The  modes  and  their  applicable  control  flags  are 
summarized  in  Tables  I  and  II.  More  detailed  descriptions 
of  the  modes  and  how  they  work  are  located  in  Appendix  A. 
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TABLE  I 


CONTROL  MODE  DEFINITIONS 


Mode 


Functional  Description 


Alphanumeric  Data  Writes  alphanumeric  characters 

on  the  sc  reen  * 

Transverse  Data  Decodes  the  data  as  a  single  bit 

oer  pixel  ana  writes  the  data  in 
an  eight  pixel  wide  vertical 
column  from  too  to  bottom. 


Raster 

Data 

Same  as  Transverse  data  but 
writes  left  to  right  on  the  same 
line. 

C  omo  1  e  x 

Data 

Decodes  the  data  as  four 
bits  oer  pixel  and  writes  left 
to  right  on  the  same  line. 

Grach i c 

Vector 

Draws  continuous  lines  between 

arbitrary  end  points. 

Graph  i  c 

Plot 

Draws  a  histogram  style  plot  by 
drawing  continuous  lines  between 
successive  y-axis  points  while 
incrementing  the  x-axis  from 
left  to  riaht. 

Graph  i  c 

Cartesian 

Draws  solid  rectangles  be¬ 

tween  arbitrary  end  ooints. 

Graphic 

Element 

Draws  a  dot  at  specified  point. 

19 


TABLE  II 


CONTROL  FLAG  DEFINITIONS 


Name 


Functional  Description 


Index  Address i ng 
Reverse  Background 

Additive  Write 

Doub 1 e  Width 

Fixed  Point 


Causes  indexed  addressing  to  be 
in  effect. 

Causes  ones  written  in  memory  to 
become  zeros  and  vice-versa. 

Causes  the  new  image  to  written 
Hon  top"  of  the  existing  image. 

Doubles  the  width  of  generated 
data  by  writing  each  bit  of  data 
into  two  elements  instead  of 
one  . 

Uses  the  ooint  defined  by  the 
contents  of  the  line  and  element 
index  registers  as  the  starting 
point  for  each  graphic  entity. 


VI.  SPECIAL  FUNCTIONS 


There  are  two  special  functions  which  alter  the  display. 
The  first  is  the  erase  instruction  and  the  second  is  the 
scroll  function. 

The  erase  function  simply  writes  all  zeros  or  ones  into 
memory  depending  on  the  state  of  the  background  flag  in  the 
control  mode  and  the  subchannels  selected. 

The  scroll  function  creates  a  moving  window  effect  by 
moving  the  image  vertically  for  a  specified  number  of  lines. 
A  positive  or  negative  number  i n o i cates  which  direction  the 
image  will  move.  Images  that  are  scroll ea  off  the  top  of 
the  screen  re-enter  the  bottom  and  vice-versa. 
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VII 


GENERAL  USER  INTERFACE  DESIGN 


One  of  the  governing  constraints  in  developing  software 
for  graphics  output  is  the  fact  that  it  is  harder  to 
describe  a  picture  than  it  is  to  describe  a  table  of  words 
or  numbers. 

For  this  reason#  some  of  the  normal  principles  of  good 
system  design  apol y  with  exceptional  force*  The  user  who 
has  the  job  of  describing  a  picture  must  be  provided  with  a 
set  of  instructions  and  graphic  tools  that  enable  him  to 
concentrate  on  the  image  he  wishes  to  create*  The  user  must 
not  be  distracted  by  irritating  details  imposed  by  the 
peculiarities  of  the  hardware.  He  must  be  allowed  to  ex¬ 
press  alqorithims  as  he  conceives  them#  and  be  able  to  trace 
and  correct  errors  with  a  minimum  of  trouble.  It  is  essen¬ 
tial  that  the  graphics  system  be  simple  to  oroaram  (31. 

An  excellent  general  approach  to  designing  a  user  inter¬ 
face  for  graphics  systems  is  expressed  by  Wagner  and  LaHood 
[33.  It  describes  some  general  guidelines  in  which  a  level 
structure  is  built. 

A  *  MULTILEVEL  STRUCTURE 

A  multilevel  design  is  based  on  buildina  blocks  which# 
at  the  lower  levels#  involve  efforts  to  provide  an  efficient 
interface  between  the  computer  and  the  graphic  device. 
Higher  levels  of  software  are  then  developed  to  increase  the 
productivity  of  the  total  system.  Routines  on  the  lower 
levels  are  dependent  on  hardware#  but  as  levels  increase# 
the  dependence  on  hardware  decreases#  and  the  complexity  of 
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t  he  f unc t ions 


performed  by  software  increases 


At  the 


highest  level  the  routines  are  totally  independent  of 
hardware. 

1*  Level  I  -  Primitive  Hardware  Oriented  Subroutines 

Level  I  routines  are  intimately  concerned  with  the 
hardware  characteristics  of  the  device.  These  form  the 
basis  for  building  Level  II  routines.  Examples  are  primitive 
display  command  utilities#  display  instruction  assembler# 
interrupt  handling  routines#  and  device  controllers. 

2.  Level  II  -  Complex  Information  Handling  Subroutines 
Level  II  routines  combine  the  facilities  of  the 

operating  system  with  the  hardware  oriented  routines  of  Lev¬ 
el  I  to  provide  the  programs  and  user  oriented  languages 
to  Pe  used  at  Level  III.  Examples  are  file  management# 
buffer  management  utilities#  and  utilities  that  convert  user 
defined  coordinate  systems  to  a  device  dependent  coordinate 
sy s  t  em. 

3.  Level  III  -  Generalized  User  Oriented  Subroutines 
Level  III  routines  have  the  ability  to  perform 

several  Level  II  routines  to  accomplish  a  single  task.  The 
routines  allow  spec i f i cat i on  of  disolav  functions  through 
device  independent  parameters.  They  are  called  within  a 
procedural  1 anguaae  like  C  [11#  Algol  or  Fortran.  There¬ 
fore#  they  add  to  the  capabilities  of  an  existing  implemen¬ 
tation.  Examples  are  plot  routines#  automatic  scaling# 
print  and  label  routines. 

4.  Level  IV  -  Aoplication  Lanquaae  Processors 

Level  IV  proaramming  support  is  directed  at  the  user 


22 


who  is  not  a  Programmer.  It  is  intended  to  make  him  less 
dependent  on  programming  by  simplifying  the  task  of  specify¬ 
ing  graphic  output*  Once  implemented  by  using  routines  in 
Levels  1/  II  and  III ,  and  other  programming  techniques^  user 
languages  provide  access  to  the  graphic  device  and  increase 
its  usefulness.  Examples  of  some  Level  IV  user-oriented, 
high  level  language  systems  are  MIT  Sketch  Pad  [4],  Bell 
Animation  Language  [5,6]  and  GM  Design  Analysis  System  [7]. 

VIII.  USER  INTERFACE  DESIGN  FOR  THE  RAMTEK  GX-100A 

A.  GENERAL 

In  the  design  of  a  user  interface  for  a  color  graphics 
device  a  primary  consideration  is  to  make  the  use  of  color 
as  easy  for  the  user  as  Possible.  The  user  should  be  per¬ 
mitted  to  make  up  colors  at  the  device  and  be  given  a  simple 
method  of  selecting  the  colors  desired  in  the  application 
program.  The  user  should  be  allowed  to  modify  the  colors  at 
will  either  during  proaram  execution  or  by  a  pre-execution 
selection  process.  The  user  should  be  relieved  of  select¬ 
ing  the  exact  bit  patterns  needed  to  produce  the  color  on 
the  screen.  Elimination  of  device  dependent  programming 
allows  the  user  to  think  of  color  as  it  applies  to  a  orob- 
1  em . 

It  is  necessary  to  isolate  the  user  from  the  low-level 
assembly  languages  to  allow  concentration  on  the  problem  and 
not  have  to  worry  about  when  and  how  to  issue  the  proper 
hardware  instructions  to  the  display  device.  A  user  should 


23 


be  able  to  think  in  terms  of  a  virtual  screen  space  of  his 


own  definition  and  not  be  concerned  with  hardware  address- 
i  ng  • 

When  a  user  interface  is  designed/  it  should  be  easily 
integrable  with  the  host  computer  language.  The  easiest  way 
to  accomplish  this  is  to  use  subroutine  calls  from  the  user 
program.  The  calls  should  be  keot  as  simple  to  use  as  prac¬ 
ticable.  Toward  this  end/  the  number  of  parameters  involved 
should  be  keot  to  a  minimum. 

The  user  should  be  protected  from  abnormal  termination 
as  much  as  possible  by  the  interface.  As  an  example/  the 
interfacing  routines  can  check  the  Dassed  parameters  to 
ensure  that  they  are  correct.  They  should  indicate  errors 
and  what  they  are  to  simplify  debugging.  Graphic  tools 
provided  to  the  user  should  encourage  concise/  clear1  pro¬ 
grams  i  ng . 

The  overall  or incioles  and  methods  of  level  design  as 
discussed  earlier  were  followed  in  implementing  the  inter¬ 
face  for  the  RAMTEK.  Since  Level  I  routines  were  essential¬ 
ly  complete  or  were  hardware  implemented/  the  resulting 
design  took  place  more  in  the  Level  II  and  Level  III  areas. 
It  was  decided  to  implement  the  interface  as  a  set  of 
subroutine  calls  from  the  C  [1]  programming  language  because 
C  is  the  primary  language  on  the  host  computer  and  because 
of  its  simple  subroutine  calling  format. 

As  a  first  step/  a  set  of  primitives  were  designee  to 
form  the  basis  for  other  routines  to  build  on. 
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1.  Primitive  Functions 

The  primitive  functions  make  up  the  majority  of  the 
level  II  and  level  III  routines.  The  criteria  followed  in 
choosing  the  orimitive  functions  were  clarity*  convenience* 
and  compactness.  Clarity  means  primitives  are  to  perform 
only  one  function  and  that  function  must  be  clear  and  sim¬ 
ple. 

Due  to  the  hardware  caoabi 1 i tes  of  the  RAMTEK, 
several  primitives  became  user  routines  on  Level  III  as  well 
as  being  primitives.  The  construction  of  a  set  of  primi¬ 
tives  condensed  the  entire  capability  of  tne  RAMTEK  hardware 
functions  to  21  instructions  or  subroutines.  The  primitives 
which  are  applicable  to  user  programs  are  described  in 
Append i x  B . 

B.  APPLICATION  OF  COLOR 

After  the  design  of  the  primitive  set*  it  was  necessary 
to  design  a  method  by  which  the  user  would  be  able  to  easily 
utilize  and  understand  how  to  get  color  into  a  display  and 
control  or  modify  it.  Two  Key  concepts  were  used.  The 
first  was  extended  from  an  actual  hardware  feature.  It  was 
the  video  lookup  table  concept  translated  into  a  color 
table.  The  available  colors  can  be  thought  of  as  a  book  of 
colors  from  which  the  user  can  choose  the  Page  he  wishes  to 
use.  The  page  corresponds  to  the  color  table.  Ml  the  user 
needs  to  do  is  select  the  page  (color  table)  and  color 
(entry)  desired  and  then  draw  the  entities  using  that  color. 
The  concept  works  well*  but  a  problem  arose  as  to  how  to 
present  the  information  to  the  user  so  it  is  understandable 
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and  useaole 


Humans  have  the  characteristic  of  not  all  per¬ 


ceiving  the  same  color  the  same  way,  A  shade  of  blue  to  one 
person,  may  not  be  the  same  to  another.  And  of  course,  some 
humans  have  varying  degrees  of  color-blindness.  Also, 
reproduction  of  color  in  manuals  and  photographs  may  not  be 
accurate  representations  of  the  color  the  RAMTEK  displays  on 
its  CRT.  As  a  result  of  these  considerations,  it  was  decid¬ 
ed  t  ha  t  an  interactive  orogram  should  be  designed  and  i  m  - 
plementated  into  a  subroutine  call  to  allow  the  user  to 
examine  and  work  with  the  colors  while  actually  viewina  them 
on  the  RAMTEK  screen, 

1.  Interactive  Program 

The  interactive  subroutine's  purpose  is  to  allow  the 

user  to  see  and  modify  color  tables  while  seated  at  the 

RAMTEK  keyboard.  It  embodies  several  features. 

* 

a.  Self-tutorial 

As  the  user  utilizes  the  routine,  instructions 
are  given  at  each  step  as  to  how  to  orogress  through  the 
various  eaiting  modes. 

b.  Color  Table  Display 

The  oage  representing  a  soecific  color  table  is 
designed  so  the  user  sees  the  fifteen  colors  in  three  modes; 
a  solid  block  of  color,  a  line  of  color  and  alphanumeric 
characters  of  the  color  are  displayed.  The  display  thereby 
shows  the  different  appearance  color  can  take  on  when 
displayed  in  different  shapes. 

c.  Multiple  Edit  Modes 

The  routine  provides  five  methoas  of  editing  and 
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modifying  color  tables  and  their  entries.  This  gives  max¬ 
imum  flexibility  to  the  novice  as  well  as  the  more  advanced 
user.  The  use  of  the  interactive  routine  is  explained  in 
detail  in  Appendix  A. 

2  .  Color  Cube 

The  color  cube  transforms  the  video  lookup  table 
into  a  third  dimension  to  further  aid  in  communicating  to 
the  user  how  to  construct  colors  and*  how  they  relate  to  each 
other.  The  concept  of  the  color  cube,  as  illustrated  in 
figure  5/  describes  the  4096  colors  that  can  be  created  by 
defining  the  colors  as  ordered  triples  as  follows:  (0,0,0) 
to  (0,0,15)  represent  shades  of  red,  (0,0,0)  to  (0,15,0) 
represent  shades  of  green  and  (0,0,0)  to  (15,0,0)  represent 
shades  of  blue.  By  a  careful  inverting  and  combining  of  the 
three  axis,  many  of  the  4096  colors  can  be  created. 

C.  VIRTUAL  DISPLAY  SCREEN 

One  of  the  important  considerations  of  a  successful  user 
interface  was  met  by  writing  a  routine  to  allow  the  user  to 
define  the  address  space  of  the  screen.  The  user  defines 
the  virtual  screen  bv  givinq  floating  point  cartesian  coor¬ 
dinates  representing  the  lower  left  and  upper  right  corners 
of  the  screen.  The  interface  remembers  his  declaration  and, 
until  the  user  changes  the  virtual  screen,  all  addresses  are 
transformed  from  the  virtual  coordinates  given  into  real 
screen  coordinates.  The  process  is  completely  transparent 
to  the  user.  To  further  aid  the  viewer,  an  axis  system, 
centered  where  desired,  can  be  displayed  on  the  screen. 

If  the  user  chooses  not  to  declare  a  virtual  screen,  the 
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9  ree  n 


Color  Cube 
Figure  5 
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interface  defaults  to  an  100  by  100  unit  screen.  This  iso¬ 
lates  the  user  from  real  screen  addressing  problems. 

All  virtual  screen  displacements  are  also  scaled  into 
real  screen  d i so  1 ac emen t s ,  thereby  giving  the  user  total 
freedom  to  define  the  virtual  screen  as  long  as  a  standard 

cartesian  coordinate  system  is  used* 

/ 

D.  HIGH  LEVEL  GRAPHIC  TOOLS 

A  set  of  level  III  graphic  tools  was  also  designed/  and 
its  use  and  description  is  detailed  in  Appendix  A.  Here 
simplicity/  usablity  and  unde r s t andab 1 i t y  were  the  driving 
factors  in  the  design*  When  oossibl e/  the  user  never  has  to 
pass  more  than  four  parameters.  The  higher  level  tools  are 
logical  operations  that  require  the  programmer  to  remember 
as  little  as  possible  when  utilized* 

All  high  level  tools  which  draw  graphics  figures  scissor 
[81  the  image  by  permitting  only  the  Portion  of  the  image 
that  falls  in  the  virtual  screen  to  be  displayed. 

All  routines  return  an  indication  if  an  error  has  oc- 
cured  or  an  incorrect  parameter  has  been  passed/  thereby 
providing  a  debugging  capability  to  the  user. 

E.  INPUT  AND  OUTPUT  ROUTINES 

Three  subroutine  calls  were  developed  to  provide  the 
user  with  an  interactive  inout/outout  capability.  The  first 
is  used  by  the  user  to  retrieve  single  ASCII  character  codes 
from  the  RAMTEK  keyboard.  The  second  is  used  by  the  user  to 
return  an  octal  or  decimal  number  from  the  RAMTEK  keyboard. 
The  third  is  used  to  return  a  floating  ooint  number  to  tne 
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user  from  the  RAMTEK  keyboard.  These  routines  provide  a 
powerful  tool  to  the  user  in  programming. 

F.  MAINTAINABILITY 

The  functional  design  and  level  structuring  serve  to 
make  servicing  the  interface  an  easy  task.  When  a  specific 
function  does  not  perform  as  expected,  the  portion  of  the 
interface  which  applies  to  that  function  is  easy  to  find  and 
isolate  for  testing  and  debuqginq.  Most  of  the  interface 
routines  do  error  checking  and  s e 1 f -do c umen t a t i on  when  an 
error  occurs. 


IX.  RECOMMENDATIONS 

A.  USER  INTERFACE  ADDITIONS 

The  following  modifications  to  the  user  interface  are 
recommended.  The  design  and  implementation  of  a  complement¬ 
ing  data  structure  to  hold  and  control  display  entities  for 
transfer  to  and  from  the  RAMTEK  on  user  command  would  be  an 
excellent  and  powerful'  addition  to  the  present  interface. 
The  data  structure  could  utilize  the  existing  routines  with 
few  changes.  Such  an  addition  would  aid  the  user  by  allow¬ 
ing  selective  display  and  erasure  of  user  entities  with  a 
single  command . 

Also,  further  interfacing  of  the  RAMTEK  keyboard  to  pro¬ 
vide  cursor  control  and  readback  of  virtual  or  real  screen 
coordinates  from  its  location  would  be  extremely  useful. 
Several  of  the  unused  keys  could  be  turned  into  function- 
type  switches  as  well. 
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B.  ADDITION  OF  HIGH  LEVEL  USER  ROUTINES 


/ 


More  routines  to  give 

the  PAMTEK  a  dynamic  qraohics 

capability  is  possible, 

but  limited  by  the  raster  rate  and 

data  transfer  rate.  Move 

routines  and  selective  erasure  of 

entities  can  be  accomol i shed  within  the  confines  of  a  well 
defined  data  structure. 


X. 

CONCLUSIONS 

The  user  interface  as 

desianed  and  implemented  is  work- 

ing  with  no  known  software  buos .  The  entire  range  of 
hardware  capabilities  of  the  RAMTEK  have  been  successfully 
incorporated  and  tested.  Several  successful  high  level 
routines,  most  notably  the  plotting  routines,  oemonstrate  a 


high  degree  of  usefulness 

and  are  indicative  of  the  caoabil- 

ities  that  a  color  device 

in  conjuction  with  an  aaeauate 

software  interface  has  to 

offer. 
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APPENDIX  A:  USER  MANUAL 


I  .  INTRODUCTION 

The  RAMTEK  GX-100A  is  a  color,  raster  scan  display  dev¬ 
ice/  the  heart  of  which  is  a  color  cathode  ray  tube  not 
unlike  a  home  color  television  set.  In  f act  /  its  raster 
scan  method  for  generating  a  picture  is  identical  to  commer¬ 
cial  cathode  ray  tubes.  At  this  point  the  similarity  ends. 
Instead  of  decoding  signals  transmitted  by  a  television 
broadcast  station,  the  RAMTEK  gets  the  information  for  its 
picture  from  a  soecial  video  generator  which  reads  the  con¬ 
tents  of  a  M 0 S  refresh  memory  which  contains  all  the  infor¬ 
mation  needed  to  oroauce  an  image  on  the  screen.  It  is  not 
within  the  scope  of  this  manual  to  go  into  the  details  of 
how  the  electronics  functions*  but  to  inform  the  user  on  how 
to  use  the  device  to  ai sol  ay  the  desired  image. 

A  brief  descriotion  of  the  parts  of  the  RAMTEK  will  be 
given  followed  by  a  discussion  of  its  various  display  mooes. 
Next  a  discussion  of  how  the  user  can  define  and  utilize 
colors  will  be  presented. 

The  user  is  also  directed  to  Aopendix  B  for  information 
on  how  the  user  routines  implemented  in  the  interface  are 
used  and  what  their  functions  are.  Periodically  small  se¬ 
quences  of  C  code  will  be  listed.  These  bits  of  code  are 
not  intended  to  run  without  the  necessary  C  and  user  inter¬ 
face  routines  that  must  precede  them.  They  are  Presented  to 
demonstrate  how  certain  instructions  are  utilized. 
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II.  THE  RAMTEK  DISPLAY  SYSTEM 


A  more  detailed  discussion  of  the  functioning  of  the 
RAMTEK  can  be  found  in  the  RAMTEK  GX-100A  [9]  and  RAMTEK 
GX-1008  (21  programmers  manuals. 

A.  GENERAL 

The  RAMTEK  consists  of  a  software  interface  to  the  user, 
a  display  generator,  keyboard,  video  lookup  table  and  a 
cathode  ray  tube.  Their  relationship  is  illustrated  in  fig¬ 
ure  A-  1  . 


User  Interface,  RAMTEK  Relationship 
Figure  A  - 1 

The  user  program  executes  on  the  PDP-11/50.  When  the 
appropriate  instruction  is  executed,  the  interface  between 
the  program  and  the  display  generator  for  the  RAMTEK  is 
activated.  Information  can  be  sent  via  the  interface  to  the 
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display  generator  from  the  user  program  or  the  keyboard. 
Information  can  also  be  sent  from  the  keyboard  via  the  in¬ 
terface  to  the  user  program,  After  the  display  generator 
interprets  its  instructions  and  constructs  the  display  in 
its  ROM  memory*  the  image  is  generated  on  the  CRT  according 
to  the  colors  contained  in  the  video  lookuo  table.  Any 
image  will  remain*  unless  over-written/  for  an  indefinite 
period  of  time  in  the  ROM  memory. 

The  keyboard  is  interfaced  to  the  user  program  and  to 
the  instruction  display  generator.  Information  can  be 
passed  from  the  keyboard  in  the  form  of  ASCII  character 
codes  to  the  user  program  or  to  the  display  generator  and 
finally  to  the  CRT  screen.  The  keyboard  also  contains  eight 
function  switches  to  control  the  action  of  a  cursor  which  is 
displayed  on  the  screen.  The  address  of  the  cursor  on  the 
screen  is  always  available  to  the  user  orogram  via  the  i n- 
t  e  r  f  ac  e  . 

The  video  lookup  table  contains  the  coded  information 
which  is  used  in  generating  color.  The  table  is  available 
via  the  interface  to  the  user  program.  By  modifying  the 
contents  of  the  table*  various  colors  can  be  displayed  on 
the  sc  reen . 

The  RAMTEK  graphics  display  in  the  Naval  Postgraduate 
School  Computer  Laboratory  utilizes  a  raster  scan  cathode 
ray  tube  with  a  screen  resolution  of  240  horizontal  lines 
and  640  elements  on  each  line*  A  specific  element  and  line 
is  referred  to  as  a  pixel.  This  device  has  a  high  element 
resolution  and  a  low  line  resolution.  Therefore*  the 
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quality  of  some  images  on  the  RAMTEK  can  be  rather  poor. 
Lines  that  are  not  horizontal  or  vertical  are  drawn  with  a 
noncontiguous,  staircase  effect.  When  utilizing  the  device 
these  resolution  factors  should  be  kept  in  mind  especially 
when  operating  in  a  data  mode.  Addressing  the  CRT  screen  is 
discussed  in  the  section  on  Virtual  Screen  Addressing. 

Color  is  generated  by  mixing  three  primary  colors;  blue, 
green  and  red  in  varying  intensities.  Using  color  is  dis¬ 
cussed  in  a  later  section. 

B.  VIRTUAL  SCREEN  ADDRESSING 

The  initialization  of  the  RAMTEK,  which  is  accomolisned 
by  the  instruction  r  a  m  t  e  k  (  )  ,  presets  the  virtual  screen  to  a 
standard  cartesian  coordinate  address  space  with  (0.0, 0.0) 
as  the  lower  left  corner  of  the  screen  and  (100.0,100.0)  as 
the  upper  riqht  corner.  The  virtual  screen  can  be  redefined 
by  issuing  a  screen(x,y,xl,yl)  instruction. 

screenO  redefines  the  virtual  screen  by  setting  the 
lower  left  corner  to  (x,v)  and  the  upper  right  corner  to 
(xl,yl)  •  The  only  restrictions  are  that  the  two  points 
define  a  valid  cartesian  coordinate  system  and  the  four 
values  are  floating  point  numbers.  All  addresses  and  dis¬ 
placements  issued  subsequent  to  a  screenO  instruction  are 
interpreted  according  to  the  defined  virtual  screen. 

The  virtual  screen  is  addressed  by  specifing  an  x,y 
coordinate  with  a  strtxv(x,y)  instruction.  The  specified 
address  (x,y)  establishes  the  current  operating  point  (COP) 
at  that  address.  The  COP  is  initially  located  at  the  lower 
left  corner  of  the  virtual  screen  whenever  a  screen  is 


35 


defined 


The  COP  is  occasionally  modified  after  certain 


operations  are  performed  as  indicated  in  Aopendi x  B  and  in 
the  section  on  display  modes. 

There  are  three  modes  of  addressinq  the  screen;  abso¬ 
lute,  indexed  and  relative. 

1.  Absolute  Addressinq 

In  absolute  addressing  the  user  specifies  a  specific 
location  on  the  user-defined  screen  by  issuing  a 
strtxy(x,y) •  The  'x*  and  'v*  values  establish  the  location 
of  the  COP. 

2.  Indexed  Addressing 

To  utilize  indexed  addressing,  the  user  must  issue 
an  inqex(i,x,y)  instruction.  If  1 i *  is  equal  to  one,  indexed 
addressing  is  initiated.  Subsequent  to  tnis  instruction, 
all  addresses  specified  by  the  user  are  interpreted  accord¬ 
ing  to  the  values  'xf  and  fy'  contained  in  the  last  indexC) 
instruction.  For  example,  if  a  s t r t x y (  1  0  .  0  ,  1  0 . 0  )  is  issued 
after  an  i nde x ( 1 , 1 5 . 0 , 2 0 . 0 )  has  been  issued,  the  resulting 
COP  is  (25.0,30.0  )  . 


To  deselect  indexed  addressing  it  is  necessary  to 
issue  an  index ( )  instruction  with  'i*  equal  to  zero.  The  x 
and  y  values,  if  any,  are  ignored  and  the  user  is  returned 
to  the  absolute  addressinq  mode. 

3.  Relative  Addressinq 

The  hardware  relative  addressing  is  implemented  by  a 
single  instruction.  The  issuing  of  a  pointr(x,y)  instruc¬ 
tion  utilizes  relative  addressing.  to  hen  issued,  the  COP  is 
calculated  by  taking  the  old  COP  x  and  y  values  and  summing 
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them  with  the  pointrO  x  and  y  values.  For  example/  if  the 
old  COP  is  (22.0/50.0)/  and  a  pointr(30.0/-10.0)  is  issued/ 
the  new  COP  becomes  (52.0/40.0).  Relative  addressing  is 
only  utilized  when  a  oointrO  instruction  is  issued  and 
always  refers  to  the  last  COP. 


III.  CONTROL  MODFS  AMO  CONTROL  FLAGS 

The  RAMTEK  operates  in  any  one  of  eight  modes.  Each 
mode  has  associated  with  it  certain  control  flags  which 
modify  its  operation  in  the  mode  selected.  Table  A  - 1  sum¬ 
marizes  the  control  modes  and  control  flags  and  their  rela- 
t  i  o  n  s  h  i  p  . 

Control  modes  are  set  by  issuing  a  setmoae(a/b)  instruc¬ 
tion.  The  value  of  'a'  indicates  the  mode  the  RAMTEK  is  to 
be  placed  in.  The  value  of  ' b '  tells  the  interface  whether 
to  save  the  control  flags  of  the  orevious  mode  or  not.  The 
values  of  'a'  and  'b'  that  may  legally  be  assigned  are  sum¬ 
marized  in  Appendix  B.  The  control  modes  are  as  follows: 

A.  ALPHANUMERIC  DATA  MODE 

Alohanumeric  Mode  is  the  default  mode  upon  initializa¬ 
tion  of  the  RAMTEK.  All  data()  instructions  issued  while  in 
this  mode  are  interpreted  as  passing  alphanumeric  data.  The 
data  is  processed  leftmost  byte  first  and  is  interpreted  as 
eight  bit  extended  ASCII  character  codes.  Each  received 
character  code  is  transformed  into  a  dot  matrix  character 
font  which  is  five  real  screen  elements  by  seven  real  screen 
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lines  in  dimension* 


The  character  font  is  within  a  seven 


element  by  twelve  line  matrix  as  illustrated  in  figure  A-2. 
The  entire  character  set  is  illustrated  in  reference  (21. 


OLD  COP 


RAMTEK  Character  Font 
Figure  A -2 
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TABLE  A - I 


CONTROL  MOOES  AND  CONTROL  FLAGS 


Definitions: 

IX  -  Indexed  Addressing 
8K  -  Reverse  Background 
AW  -  Additive  Write 
DW  -  Double  Width 
FP  -  Fixed  Point 

YES  -  Indicates  the  Control  Flag  has 
effect  in  the  Control  Mode 
NO  -  Indicates  the  Control  Flag  does 
not  have  effect  in  the  Control 
Mode 


Mode  Control  Flags 


No  . 

Name 

IX 

BK 

AW 

DW 

FP 

0 

A ] phanume  r i c 

YES 

YES 

YES 

YES 

NO 

1 

T  ransverse  Data 

YES 

YES 

YES 

YES 

NO 

2 

Raster  Data 

YES 

YES 

YES 

YES 

NO 

3 

Comp  lex  Data 

YES 

YES 

NO 

YES 

NO 

a 

Grpah i c  Vec  tor 

YES 

YES 

NO 

NO 

YES 

5 

Graohic  Plot 

YES 

YES 

NO 

YES 

YES 

6 

Graohic  Cartesian 

YES 

YES 

NO 

NO 

YES 

7 

Graphic  Element 

YES 

YES 

NO 

YES 

NO 
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The  transmitted  ASCII  characters  are  displayed  starting 
at  the  COP  from  left  to  right  on  the  same  line  as  illustrat¬ 
ed  in  figure  A - 2 •  If  more  than  91  characters  are  written  on 
one  line^  they  will  "wrao  around"  and  overwrite  on  the  same 
line.  No  more  than  twenty  character  lines  can  be  displayed 
on  the  sc  reen  . 

Completion  of  execution  of  a  d  a  t  a ( )  instruction  causes  a 
"line  feed"  and  "carriage  return" •  Each  subseauent  data ( ) 
instruction  will  display  on  the  next  alphanumeric  line  at 
the  same  starting  element  as  illustrated  in  figure  A  - 2 .  The 
new  COP  after  each  execution  is  also  illustrated  in  figure 
A-2  • 

When  the  characters  are  drawn  on  the  RAMTEK  screen,  the 
character  appears  in  the  designated  color  while  the  rest  of 
the  matrix  is  drawn  in  the  background  color* 

1.  Applicable  Control  Flaps  , 
a*  Indexed  Addressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing* 

b.  Reverse  Background  Flag 

If  set,  the  character  is  displayed  in  the  back¬ 
ground  color  and  the  rest  of  the  matrix  in  the  selected 
color  as  illustrated  by  the  1 Y 1  in  figure  A-2. 

c.  Additive  Write  Flag 

If  set,  the  character  is  written  over  whatever 
image  happens  to  be  at  the  same  location  on  the  screen.  The 
use  of  the  additive  write  flag  is  convenient  for  combining 
characters  to  create  special  characters  or  writing 
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characters  close  to  other  i nages  to  avoid  destroying  a  por¬ 


tion  of  the  existing  image  when  the  seven  by  twelve 
is  written.  The  second  aool i cat i on  is  illustrated  in 

A-3. 

d.  Oouble  Width  Flag 

If  set,  causes  the  displayed  characters 
twice  as  wide  as  normal  as  i  1  1 ustrated  in  figure  A-a 
use  of  double  width  characters  decreases  the  maximum 
of  characters  oer  line  to  ^5. 

2.  Other  Instructions 

See  also  stroutC)  and  IttrO  on  Aooendix  8  for 
tional  alphanumeric  generating  capability. 


ma  t  r i x 
figure 

to  be 
.  The 
numbe  r 

add  i  - 


Effect  of  Additive  Write  Flag  in  Alohanumeric  Mode 

Figure  A-3 


NORMAL 


Effect  of  Double  width  Flag  in  Alphanumeric  Mode 

Figure  A -a 

a.  transverse  data  ^ode 

All  d  a  t  a  (  )  instructions  issued  in  transverse  data  mode 
are  interpreted  as  passing  transverse  data.  Received  data 
is  written  in  its  raw  format,  that  is,  each  data  byte  Coro- 
cessed  leftmost  first)  is  interpreted  as  a  single  bit  oer 
oixel  description  of  eight  consecutive  pixels  along  a  par¬ 
ticular  real  screen  line.  As  illustrated  in  figure  A-5, 
consecutive  data  bytes  are  written  from  left  to  right  begin¬ 
ning  at ( the  COP  and  continuing  down.  All  subseauent  bytes 
are  written  beginning  at  the  same  element  on  the  next  line. 
The  COP  after  the  operation  is  indicated  in  figure  A-5. 

The  typical  use  of  transverse  data  is  to  define  special 
symbols  and  characters  which  can  not  be  found  in  the  stan¬ 
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dard  character  set. 


Data: 


Transverse  Data  Processing 
Figure  A  -  5 

1.  Aoolicable  Control  Flags 

a.  Indexed  Acdressing  Flag 

The  effect  of  indexed  addressing  is  as  exolained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Background  Flag 

If  set/  the  data  is  displayed  as  indicated  in 
figure  A-fe.  In  effect/  the  comol ement  of  the  data  is 
d i sp 1  a ved . 

c.  Double  Width  Flag 

If  set/  each  bit  is  reflected  in  two  consecutive 
pixels  instead  of  one/  thereby  giving  an  image  sixteen  □  i  x  - 
els  wide  instead  of  eight.  The  result  is  illustrated  in 


figure  A -6 


d 


Additive  flrite  Flag 


If  set/  the  transmitted  data  is  written  over 
whatever  image  happens  to  be  at  tne  same  location  on  the 
screen. 


Data: 


015022 
1 33000 
000101 


000  1  1  0  1  0 
101  101  10 
00000000 


00010010 

00000000 

0100000 


OLD 

COP 


NEW 

COP 


NEW 

COP 


Effect  of  Reverse  Background  and 
Double  Aidth  Flags  on  Transverse  Data 


Figure  A -6 


C.  RASTER  DATA  MODE 

Raster  data  mode/  except  for  the  direction  of  the  writ* 
ing  process/  is  identical  to  the  transverse  data  mode.  As 
illustrated  in  figure  A-7/  the  consecutive  bvtes  transmitted 
by  the  data ( )  instruction  are  written  horizontally  from  left 
to  right  beginning  at  the  COP.  All  subseouent  bytes  are 
written  beginning  at  the  next  pixel  on  the  same  line.  The 


COP  after  the  ooerat ion  is  as  illustrated  in  figure  A-7. 
The  control  flags  that  apoly  to  transverse  data  mode  also 
apply  to  raster  data  mode  in  the  same  manner. 


Data:  013232 

127076 


000  1  0  1  1  01  00  1  1  0  1  0 
1  0  1  0  1  1  1  000  l  1  1 1 1 0 


Raster  Data  Processing 


Figure  A-7 


D.  COMPLEX  DATA  MODE 

This  mode  is  used  to  write  data  on  the  screen  exactly 
the  same,  way  that  raster  data  does.  However/  a  third  dimen¬ 
sion  is  added  in  this  mode  in  that  each  pixel  is  described 
by  four  bits  of  the  passed  data.  Therefore/  a  single  data 
word  describes  four  oixels  instead  of  two  as  in  the  previous 
data  modes. 

The  benefit  of  this  mode  is  that  tne  color  of  each  oixel 
being  passed  is  defined  by  the  four  bits  that  are  assigned 
to  that  pixel.  The  four  bits  reoresent  a  number  from  zero 
through  fifteen  which  is  used  as  a  oointer  into  the  color 
lookup  table.  If  the  pointer's  value  is  six  (0110),  the 
color  of  the  Pixel  will  be  whatever  is  indicated  in  entry 
six  of  the  color  table  in  use. 

It  can  be  seen  that  this  mode  overrides  the  color  desig¬ 
nated  by  the  c o 1 o r ( )  instruction.  Interesting  images  can  be 
achieved  by  the  use  of  this  data  mode.  All  flags  applicable 
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to  paster  data  are  apolicable  to  complex  data  except  ad di- 
tive  write.  Piqure  A  - 8  illustrates  how  a  data  word  is  in¬ 
terpreted  in  this  mode. 


DATA  WORD: 


= 175163 


Complex  Data  Processing 
Figure  A  - 8 


E  •  GRAPHIC  VECTOR  MODE 

The  graphic  vector  mode  draws  lines  between  arbitrary 
end  points.  The  starting  point  is  defined  by  the  existing 
COP  or  can  be  defined  by  issuing  a  strtxy ( )  to  estaolish  the 
new  COP,  The  end  point  can  be  defined  by  issuing  either  a 
DointrO  instruction  or  a  oointC)  instruction.  The  first 
uses  relative  addressing  and  the  second  uses  absolute  or 
indexed  dependinq  upon  the  control  flags*  condition. 

After  execution  of  an  instruction,  the  COP  is  then  the 


end  point  of  the  vector  just  drawn 


Therefore 


a  linked 


1  i  n  e  / 


as  illustrated  in  figure  A  -  9 ,  can  be  drawn  by  issuing 


a  strtxyO  followed  by  successive  o  o  i  n  t  (  )  or  pointrC)  in¬ 
structions. 

Instructions:  setmode(u>0)  ; 

strtxvCIO. 0/10.0); 
ooint(5. 0/8.0); 
do i n  t ( 1  2 . 0,9,0); 

DO intr(-l. 0/2.0); 


Drawing  Vectors  in  Graphic  Vector  Mode 
F i gu  re  A -9 


1.  Apolicable  Control  Flags 

a.  Indexed  Addressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Background  Flag 

If  set/  the  lines  are  drawn  in  the  background 

color. 

c.  Fixpoint  Flag 

If  set/  causes  the  Doint  issued  by  a  strtxyO  to 
be  the  starting  point  for  all  subsequent  end  points  issued. 
Therefore/  the  lines  are  drawn  with  a  common  point  as  illus¬ 
trated  in  figure  A  —  1 0 . 


Instructions:  se t mode ( 4 / 0 ) ; 

f i xot ( n ; 
strtxy(5. 0/5.0)  ; 
p  o  i  n  t  (  8  . 0/7.0); 
ooint (6. 0/5.0)  ; 
pointr(-1.0/-1.0); 


(s.  0.7.  o) 


Drawing  Vectors  with  Fi xooint  Flag 


Figure  A  -  l  0 


F*  GRAPHIC  PLOT  MODE 

The  functions  performed  by  the  graphic  olot  node  have 
been  implemented  as  a  set  of  olot  routines  in  the  user  in¬ 
terface.  The  three  routines  are  olotctO/  plotlnC)  '  and 
o  1  o  t  H  ( )  . 

The  first  plots  a  function  as  a  series  of  points.  The 
second  plots  a  function  as  a  continuous  line  and  the  third 
plots  a  function  in  a  histogram  style  plot.  Each  of  the 
methods  requires  the  user  to  specify  the  points  to  be  plot¬ 
ted.  The  three  plotting  methods  are  illustrated  in  figure 
A  - 1  1  .  Detailed  instructions  on  their  use  can  be  found  in 
Appendix  8.  It  is  recommended  that  these  routines  be  used 
in  lieu  of  the  graphic  plot  mode  as  they  are  simpler  to  use 
and  provide  a  more  powerful  capability.  However/  for  the 
programmer  who  is  interested  in  using  the  assembly  language 
level  instructions  necessary  in  this  mode/  he  is  referred  to 


reference  t21 


**  #  * 


plotH  (  ) 


Plotting  Methods 
Figure  A  -  1  1 

G.  GRAPHIC  CARTESIAN  MODE 

The  graphic  cartesian  mode  draws  solid  rectangles 
between  arbitrary  endpoints.  The  endooints  a  e  f i ne  opoosite 
corners  of  a  rectangle.  The  COP  is  always  the  starting 
point  of  the  drawing  unless  a  new  COP  is  defined  with  a 
strtxyO  instruction.  The  second  ooint  can  be  issued  with  a 
ooint (  )  or  oointrC)  instruction.  After  the  coeration  is 
oerformed/  the  new  COP  is  the  second  ooint  that  was  issued. 

By  issuing  successive  ooints»  linked  rectangles  can  oe 
drawn  as  illustrated  in  figure  A - 1 2 .  In  this  case/  the  end¬ 
ing  ooint  for  one  rectangle  becomes  the  starting  ooint  for 
the  next. 
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1.  Apolicable  Control  Flags 

a.  Indexed  Addressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Background  Flag 

If  set  >  the  rectangles  are  drawn  in  the  back¬ 
ground  color. 

c.  Fixed  Point  Flag 

If  set/  all  rectangles  are  drawn  with  a  common 
starting  point  much  in  the  same  way  it  is  done  in  the  graoh- 
ic  vector  mode.  A  strtxyC)  instruction  determines  the  com¬ 
mon  point/  and  subseouent  point!)'  or  pointrO  instructions 
determine  the  rectangles  as  illustrated  in  figure  A  -  l  2  . 


Instructions:  setmode(6/0); 

strtxyCtO. 0/6.0); 

point (12. 0/8.0);  //  draws  A. 

point(13. 0/9.0);  //  draws  8. 

f i xot (  1  )  ; 

strtxy(5. 0/8.0)  ; 

point (6. 0/6.0);  / /  draws  C. 

do  i  n t ( U  .  0 / 7  .  0 ) ;  //  draws  0. 


Drawing  Rectangles  with  and 
Without  Fixooint  Flag 


F i gu  re  A  - t  2 
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H.  GRAPHIC  ELEMENT  MODE 


The  graphic  element  mode  draws  a  sinqle  pixel  on  the 
screen  as  determined  by  a  ooint ()  instruction  or  a  pointrC) 
instruction.  After  execution,  the  COP  is  on  the  same  real 
screen  line  and  one  screen  element  to  the  right. 

1.  Applicable  Control  Flags 

a.  Indexed  Addressing  Flag 

The  effect  of  indexed  addressing  is  as  explained 
above  in  Virtual  Screen  Addressing. 

b.  Reverse  Background  Flag 

If  set,  the  pixels  are  drawn  in  the  background 

color. 

c.  Double  Width  Flag. 

If  set,  two  Consecutive  pixels  on  the  same  line 
are  drawn  instead  of  one. 


IV.  USING  COLOR 

As  mentioned  earlier,  all  images  that  are  displayed  on 
the  screen  are  displayed  according  to  an  entry  in  the  video 
lookup  table  which  can  also  be  referred  to  as  the  color 
lookup  table.  This  section  will  discuss  how  to  define 
colors  the  user  desires,  load  the  color  lookup  table/  use 
the  special  interactive  routine  to  build  color  tables  and 
use  the  color  lookup  table  in  user  programs. 

A.  DEFINING  COLORS 

The  RAMTEK  hardware  defines  colors  by  combining  red. 
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green  and  blue  in  varying  intensities  to  produce  color. 
Since  the  color  lookup  table*  from  which  the  CRT  receives 
its  instructions  on  how  to  mix  the  three  colors*  stores 
information  in  digital  format*  the  user  is  limited  to  4096 
possible  color  definitions.  Since  the  table  has  a  finite 
length  of  sixteen  twelve  bit  entries  and  only  one  table  can 
oe  used  at  any  one  time*  only  sixteen  colors  can  be 
displayed  at  any  one  time  on  the  screen.  It  must  also  be 
keot  in  mind  that  entry  zero  in  the  table  is  used  as  the 
background  color  that  is  to  be  displayed  on  the  screen 
thereby  leaving  fifteen  colors  for  image  drawing. 

In  order  to  define  an  entry  in  the  color  lookup  table* 
it  is  first  important  to  examine  how  the  color  lookup  table 
stores  its  information. 

1.  The  Color  Lookup  Table 

There  are  sixteen  entries  in  the  color  lookup  table. 
Each  entry  represents  the  code  for  a  color  in  a  twelve  bit 
word.  As  illustrated  in  figure  A  —  1 3  *  each  word  is  broken 
into  three*  four  bit  binary  numbers  which  represent  the 
intensities  of  blue*  green  and  red  to  be  mixed. 


blue 

green 

red 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 

Color  Lookup  Table  Entry  Format 
Figure  A  -  1 3 
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It  is  convenient  to  think  of  the  entry  in  each  table 
as  an  ordered  triple:  (0-15/0-15*0-15).  This  can  be  extend¬ 
ed  into  a  three-dimensional  definition  of  the  color  soace  in 
which  the  RAMTEK  is  capable  of  displaying  color.  Figure  5 
in  the  earlier  section  on  Application  of  Color  illustrates 
this  concept.  The  x-axis  contains  the  sixteen  Possible 
shades  of  blue?  the  y-axis  contains  the  sixteen  possible 
shades  of  green  and  the  z-axis  contains  the  sixteen  oossible 
shades  of  red.  By  moving  within  the  confines  of  the  cube* 
all  4096  colors  are  defined*  and  their  relationship  to  each 
other  is  illustrated. 

2 .  Defining  Color  Table  Entries 

In  order  to  define  an  entry  in  the  color  lookup 
table*  it  is  necessary  to  transform  from  an  ordered  triple 
to  the  twelve  bit  coded  form.  This  is  accomplished  by  a 
special  routine  called  t r i p 1 e ( b * g * r ) .  The  ordered  triple 
(b*g*r)  directly  corresponds  to  the  color  cube  location 
reoresenting  the  color  the  user  desires.  The  routine  re¬ 
turns  the  properly  coded  entry  for  loading  into  a  color 
table. 

B.  LOADING  THE  COLOR  LOOKUP  TABLE 

The  RAMTEK  interface  system  oermits  the  use  of  eighteen 
separate  color  tables.  The  first  four  tables  (0-3)  are 
reserved  system  tables  and  cannot  be  modified  in  any  way. 
Some  of  the  other  tables  already  have  entries  in  them  for 
the  benefit  of  the  user  who  wishes  to  use  them*  and  others 
are  emo t  y  . 

There  are  three  methods  of  loading  a  color  lookup  table 
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in  the  user's  program.  One/  the  interactive  color  routine 
will  be  discussed  separately.  The  other  two  are  discussed 
here.  The  first  is  a  method  for  loadina  an  entire  color 
lookup  table/  and  the  second  is  for  loadinq  a  single  entry 
in  a  color  lookup  table. 

1.  Loading  an  Entire  Table 

To  load  a  whole  color  lookup  table  requires  a  series 
of  operations.  First/  the  user  needs  to  declare  a  sixteen 
word/  linear  integer  array.  Then  it  is  necessary  to  load 
each  entry  of  the  array  from  zero  to  fifteen  with  the  six¬ 
teen  colors  that  are  desired.  In  order  to  accomplish  this/ 
it  is  recommended  that  the  triple!)  routine  be  used  to  code 
the  ordered  triples  and  then  assign  the  returned  codes  to 
each  entry  in  the  array. 

After  the  array  has  been  loaded/  it  is  then  entered 
into  the  desired  color  lookup  table  by  the  routine 
C 1 rt b 1 ( n / name ) .  The  parameter  'n'  is  the  number  of  the 
color  lookup  table  (4-17)  and  'name'  is  the  name  of  the  user 
array  which  contains  the  sixteen  coded  entries  to  be  loaded. 

An  example  of  the  code  to  load  a  color  table  is  as 

f o 1  lows: 


int  a(16);  //declares  sixteen  word  array, 
a  1 0 ]  =  t r i o I e ( 0 / 0  /  0  )  ;  //  color  black, 

all)  =  t r i p I e ( 1 5 / 0  /  0  )  ;  //  color  blue, 

a  121  =  t r i p 1 e ( 0 , 1 5 / 0 ) ;  //  color  green. 


a ( 1 5 ]  =  triple(l5/15/15)?  / /  color  white. 

clrtbl(5/a);  //loads  color  lookup  table. 


The  color  lookup  table  entries  contained  in  the  array  *  a  ' 
are  loaded  into  color  lookup  table  number  five  and  are  then 
ready  for  use, 

2  •  Single  Entry  Loading 

It  may/  at  times/  be  desirable  to  load  only  one 

entry  in  a  given  color  lookup  table.  In  order  to  do  so/  the 

entry  is  coded  with  the  triple  routine  and  then  loaded  in  a 

specific  table  and  entry  by  using  the  chnge(numb/entry/Cont) 

routine.  For  example/  to  load  the  color  defined  by  the 

ordered  triple  (5/6/10)  into  entry  three  of  color  lookup 

table  ten/  the  following  two  instructions  are  issued: 

cont  -  triole(5/6/10); 
c  h  nge ( 1 0 / 3 / con  t ) ? 

If  the  change  takes  place  in  a  color  lookup  table  that  is 
being  used  for  display/  the  change  is  reflected  on  the 

screen  immediately. 

C.  INTERACTIVE  COLOR  PROGRAM 

The  purpose  of  the  interactive  program  is  to  allow  the 
user  to  see  and  modify  color  lookup  tables  while  seated  at 
the  RAMTEK  keyboard.  It  is  recommended  that  the  new  user 

sit  down  at  the  RAMTEK  and  execute  interC)  in  order  to  get 

an  introduction  to  the  color  generating  capab i 1 i t i eso f  the 
RAMTEK.  There  are  two  basic  modes  in  which  the  routine 
operates.  Each  of  these  modes  has  a  series  of  commands 
which  the  user  can  execute.  Appendix  3  describes  the  com¬ 
mands  for  each  mode  in  detail  in  its  description  of  interC). 
1 .  Paging  Mode 

The  paging  mode  permits  the  user  to  page  through  the 
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eighteen  possible  color  lookup  tables.  Upon  execution  of 
interO  the  paging  mode  is  automatically  entered  and  a  set 
of  tutorial  instructions  are  displayed. 

2  .  Edit  Mode 

The  routine  provides  five  separate  methods  of  edit¬ 
ing  and  modifying  color  lookup  tables  and  their  entries. 
How  to  use  the  methods  is  described  in  Appendix  B  in  the 
description  of  interO  . 

a.  Table  Assignment 

Table  assignment  mode  allows  the  user  to 
copy  entries  from  any  table  into  a  designated  user  table. 

b.  Octal  Assignment 

Entries  in  a  designated  user  table  can  be 
defined  by  enteri nq  an  ordered  octal  triple  representing  the 
color  desired. 

c.  Combining  Assignment 

Entries  from  two  color  lookup  tables  can  be 
logically  OR'd  into  a  desianated  user  table  or  two  whole 
tables  can  be  0  R  *  d  into  the  user  table. 

d.  Inverting  Tables 

This  method  permits  the  user  to  invert  a 
designated  table.  Entry  zero  becomes  entry  fifteen,  entry 
one  becomes  entry  fourteen  and  so  on. 

e.  Copying  Tables 

This  method  permits  the  user  to  make  copies 
of  any  table  in  the  system  into  a  selected  user  table. 
Thus/  the  user  can  modify  a  system  table  without  destroying 
i  t  . 
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D.  PROGRAMMING  WITH  COLOR 


Using  color  on  the  RAMTEK  is  not  a  difficult  process 
once  the  user  understands  color  lookup  tables  and  their 
entries.  As  mentionec  earlier/  the  system  has  capability  at 
present  of  storing  uo  to  eighteen  color  lookuD  tables. 
Tables  zero  through  three  are  reserved  system  tables  leaving 
tables  four  through  seventeen  for  the  user.  The  system  has 
some  preloaded  tables  which  contain  a  variety  of  colors  that 
the  user  may  find  useful.  If  not,  they  can  be  destroyed  as 
des i red . 


It  is  a  good  practice  for  the  user  to  design  his  pro¬ 
grams  making  use  of  the  interO  routine.  By  placing  the 
inter!)  routine  inside  a  looo,  the  user  can  modify  the  table 
or  tables  the  orogram  uses/  run  tne  program  and  return/  if 
desired/  to  the  inter!)  routine  to  chanae  entries  in  the 
color  lookup  tables  until  the  desired  colors  are  achieved. 
The  user  should  then  save  the  codes  for  future  use. 

Issuing  a  colort(n)  instruction  in  the  user  program 
causes  the  designated  color  lookuo  taole  to  be  loaded  into 
the  RAMTEK  hardware  video  lookup  table.  All  images  are  then 
displayed  relative  to  the  colors  contained  in  table  'n'.  In 
order  to  select  a  specific  color  to  be  used/  the  color(e) 
instruction  is  issued.  All  images  drawn  subsequent  to  this 
instruction  will  be  drawn  with  the  color  contained  in  entry 
*e'  of  the  color  lookup  table  last  selected. 

For  examole/  suppose  color  table  five  was  the  table  the 

user  wished  to  use/  and  it  contained  the  following  entries: 

entry  zero  -  black  (0/0/0) 
entry  one  -  red  (0,0/15) 
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entry  two  -  blue  (15,0,0) 
entry  three  -  green  (0,15,0) 


The  following  instructions  would  disolay  a  red  rectangle,  a 
blue  line  and  a  green  letter  'A'  on  a  black  background. 
Entry  zero  always  contains  the  background  color. 


co 1 o  r  t ( 5 ) ; 
co 1  or ( 1 ) ; 

//draw  red  rectangle. 

setmode(6, 0) ; 


//loads  color  table  five, 
//selects  entry  one  (red). 


//set  Graphic  Cartesian 
mode . 

strtxy(5. 0,5.0) ; 
do i n  t ( 1 0 . 0,10.0); 

//draw  blue  line. 

color(2);  //select  entry  two  (blue), 

se t mode ( 4 , 0 ) ;  //set  Graphic  Vector  mode. 

strtxy(l5. 0,15.0); 
point (22.8, 10.5) ; 

//draw  green  letter  'A'. 

c  o 1 o  r ( 3 ) I  //select  entry  three  (green), 

se t mode ( 0 , 0 ) ;  //set  Alphanumeric  mode. 

S  t  rt  xy (50 . 0,25.0); 

data(letter,l);  //letter  is  an  array  containing 

//the  ASCII  code  for  an  'A'. 


If  at  any  time  a  new  color  table  is  entered,  all  exist¬ 
ing  images  will  change  color  to  the  entries  that  are  in  the 
new  table.  .Also,  if  at  any  time  an  entry  in  the  table  being 
used  is  changed,  any  image  on  the  screen  that  was  drawn  with 
that  entry  number  will  change  to  the  new  color.  If  in  the 
preceding  example  the  next  instruction  loaded  a  table  which 
contained  the  color  white  in  entries  one  and  two,  and  blue 
in  three,  the  rectangle  and  line  would  become  white  and  the 
letter  'A'  would  become  blue. 
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V.  PROGRAMMING  THE  RAMTEK 


There  are  two  routines  which  it  is  necessary  to  Diace  at 
the  beginning  of  any  C  program  which  desires  to  utilize  the 
user  interface  for  the  RAMTEK. 

The  r  a  m  t  e  k  (  )  routine  must  be  the  first  call  made  in  the 
user  program.  It  is  the  initialization  routine  for  the  user 
interface  and  it  opens  the  RAMTEK  device  and  keyboard. 

The  eraseO  routine  should  follow  the  ramtekC)  routine. 
This  ensures  that  any  old  images  on  the  screen  or  in  the 
RAMTEK  memory  will  be  removed. 

Appendix  8  contains  a  complete  list  of  the  user  routines 
which  will  relieve  the  user  of  a  significant  amount  of  pro¬ 
gramming  effort  in  many  cases.  Most  user  routines  return 
negative  values  for  error  conditions  or  if  incorrect  parame¬ 
ters  are  passed.  It  is  therefore  advisable  to  be  aware  of 
the  values  and  their  meanings  to  aid  in  debugging  programs. 

In  order  to  utilize  the  interface,  the  following  compile 
command  should  be  issued: 


cc  filename  - 1 r 


A.  RESERVED  WORDS 

Table  A  —  I  I  contains  a  list  of  reserve  words.  These 
words  should  not  be  used  for  user  names  in  any  programs  that 
utilize  the  user  interface  for  the  RAMTEK  device.  Some  of 
the  words  are  user  interface  routine  names  and  others  are 
variables  and  subroutine  names  in  the  interface  software. 
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TABLE  A - 1  I 


RESERVED  WORDS 


ADOFF 

FPOFF 

po i n  t  r 

adon 

f  oon 

p  r  oc  1 

ALPHA 

ge  t  f 

proc2 

axis 

get  num 

p  r  oc  3 

BKON 

graphcrt 

p  roc  4 

BKOFF 

graphelm 

proc5 

bk  rnd 

GRAPHVEC 

p t  rbu  f  f 

blank 

head 

pu  t  UD 

BLK 

headot  r 

qpt  r 

block 

heat 

qp  t  r  1 

bracket 

ho  1  dx 

at 

buff 

ho  1  dy 

auest 

by t  ecnt 

index 

q  1 

c 

i not  rs 

r  am  t  e  k 

c  hnae 

i  n  s  t  r 

RASTERD 

cl rho 1 d 

inst  1  «*  i  n  s  t  8  0 

re t  c  h a  r 

cl r  t  b 1 

inter 

s  c i ssor 

code 

i  nt  53 

SCR 

code  i  t 

i  n  t  6  0 

screen 

coke 

i  t  oa 

scrol 1 

color 

IXOFF 

SDC  0 

c  o  1  o  r  t 

IXON 

se  t  mode 

c  o  1  o  r  t  b  1 

LCM 

setup 

comb 

1 cmho 1 d 

size 

COMMA 

LER 

skip 

COMPD 

LEX 

SSC ALL 

conve 

LEI 

s  t  rout 

c  on  v  1 

LE2 

s  t  r  t  x  y 

c  ooy 

LLR 

sy  s  t  b 1 

CR 

LLX 

t  b 1  who 

data 

LL1 

TRANSD 

dat  ao 

LL2 

triple 

db 1 w i d 

LTA 

uocnt 

d i  sd 

LTD 

vector 

dumo 

1  1 1  r 

wait 

e  i  ns  t 

LXD 

WDOFF 

eoaqe 1 

mo  r e i n  s  t 

WDON 

epage2 

n  0 -n  1  7 

w  r i ton 

epaae  3 

oc  t  b  1 

x  a  x  i  s 

erase 

out 

x  m  i  n 

ERS 

pause 

xmax 

f  i  X  D  t 

o  i  c  k 

y  a  x  i  s 

f  1  i  o 

p  1  o  t  p  t 

yax i s  f 

f  name 

o 1 ot  1  n 

y  m  i  n 

f  D 

p  1  ot  h 
point 

y  ma  x 
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APPENDIX  8:  USER  INTERFACE  ROUTINE  DESCRIPTIONS 

This  Appendix  contains  the  descriptions  of  the 
interface  routines  in  the  format  that  is  followed  in 
documentation  of  the  UNIX  operating  system  in  the 
Postgraduate  School  Computer  Laboratory. 


user 

the 

Naval 


axis 


Jun  10  1976 


axis 


NAME: 


axis  -  draw  coordinate  axis 


SYNOPSIS: 

a  x  i  s  (  x  t  y  ) 
float  x ,  y ; 


DESCRIPTION: 

Draws  a  cartesian  coordinate  x  and  y  axis  on  the 
screen  with  center  at  user-defined  screen  coordinate 
(  x  ,  y  )  . 

The  operation  is  totally  indeoendent  of  any  control 
mode  issued  previously. 

The  COP  is  left  at  (max  x-value>y).  Normal  return  is 
zero. 


DIAGNOSTICS: 

Returned  -1  indicates  no  oortion  of  the  axis  lies  on 
the  user-defined  screen. 
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b  k  rnd 


Jun  10  1976 


b  k  rnd 


NAME: 

bkrnd  -  chanae  reverse  background  flag 


SYNOPSIS: 

bk  r nd ( a ) 
int  d/ 


DESCRIPTION: 

If  a  is  zero ,  the  reverse  background  flag  in  the  con¬ 
trol  mode  is  set  to  zero*  i.e.  turned  off. 

If  a  is  equal  to  oner  the  reverse  background  flag  in 
the  control  mode  is  set  to  one/  i.e.  turned  on. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassed  integer  q  is  not 
equal  to  zero  or  one. 
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block 


Jun  10  1976 


block 


NAME: 

block  -  draw  solid  block 


SYNOPSIS: 

b  1  oc  k ( x 1 / y 1 , x2 / y 2 ) 
float  xl,yl,x2,y2; 


DESCRIPTION: 

A  solid  block  is  drawn  with  opposite  corners  as  de¬ 
fined  by  user-defined  screen  coordinates  (xl,yl)  and 
(  x  2  ,  y  2  )  . 

The  COP  is  left  at  (*2/y2).  The  operation  is  indepen¬ 
dent  of  any  mode  issued  previously  but  is  sensitive  to 
all  flags  applicable  to  Graphic  Cartesian  mode. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  block  can  not  be  drawn  on 
the  user-defined  screen. 


SEE  ALSO: 

index()/  bkrndO/  dblwid!) 
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c  hnge 


Jun  10  1976 


c  h  nqe 


NAME: 

c hnge  -  change  color  table  entry 


SYNOPSIS: 

Chnge(numt), entry, cont  ) 
int  numb,  entry,  cont; 


DESCRIPTION: 

Changes  the  specified  entry  in  the  indicated  color 
table  to  the  passed  oarameter  cont.  triple!)  should 
be  used  to  put  cont  into  the  prooer  form. 

numb  is  the  table  number  in  which  the  entry  is  to  be 
changed.  entry  is  the  entry  number  to  be  changed, 
cont  is  the  integer  twelve  bit  code  which  is  1 oaaed  in 
the  specified  entry. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are  indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are  as  follows: 


Indi cates 
seventeen 

numb  i 

• 

s  less  than 

four  or  greater 

than 

Indi cates 
teen. 

ent  ry 

i s  negat i ve 

or  great  er  than 

f  i  f- 

SEE  ALSO: 

triple!) 
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cl r  t  D 1 


Jun  10  1976 


cl r  t  b  1 


NAME: 

clrtbl  -  load  color  table 


SYNOPSIS: 

cl rtbl (n,name) 
int  n  /  *name  T 


DESCRIPTION: 

Loads  color  table  number  n  with  the  codes  contained  in 
the  array  pointed  to  by  name/ 

The  array  is  an  integer  array  containing  sixteen  in¬ 
tegers  which  represent  the  octal  code  of  the  color 
table  entries  between  zero  and  sixteen.  The  array  is 
assumed  to  be  declared  sixteen  words  in  length. 


n  is  an  integer  value  which  ranges  from  four  to  seven- 
t  een . 


The  color  tables  from 
tables.  They  contain 
Table  0  -  Fifteen 
Table  1  -  Fifteen 
Table  2  -  Fifteen 
Table  3  -  Fifteen 


zero  to  four  are  system 
the  follow i n  a : 
shades  of  grey . 
shades  of  blue, 
shades  of  green . 
shades  of  red. 


d  e  f  i  n  e  d 


If  the  user  desires  to  modify  a  system  table  see 
inter!). 


/  Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  integer  n  is  less 
than  four  or  greater  than  seventeen. 


SEE  ALSO: 

triple!) 
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color 


Jun  10  1976 


color 


NAME  : 

color  -  select  color 


SYNOPSIS : 

co 1 o  r ( s ) 
i  n  t  s  ; 


DESCRIPTION: 

The  passed  integer  s  is  the  number  of  the 
current  color  table.  The  color  located 
will  be  used  for  all  subseauent  entiti 
until  a  different  color  is  issued. 

s  is  between  zero  and  fifteen. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassed  integer 
or  greater  than  fifteen. 


SEE  ALSO: 

chnge ( ) 


entry  in  the 
in  that  entry 
es  d i sd 1 ayed 


s  i s  nega t i ve 
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c  o  1  o  r  t 


Jun  10  1976 


cotort 


NAME. : 

colort  -  select  display  color  table 

SYNOPSIS: 

col ort (t ) 
i  n  t  t  ; 


DESCRIPTION: 

The  passed  oarameter  t  is  the  number  of  the  color 
table  that  is  sent  to  the  ramtek  device  for  display. 

t  is  between  zero  and  seventeen. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassed  integer  t  is  negative 
or  greater  than  seventeen. 


SEE  ALSO: 

c  1  r  t  b  1  ( ) 
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data 


Jun  10  1976 


data 


NAME  : 

data  -  display  raw  data 


SYNOPSIS: 

data (name  » 1  ) 
i  nt  *name  >  1  '• 


DESCRIPTION: 

The  raw  data  passed  in  the  linear  array  Pointed  to  by 
name  is  displayed  on  the  ramtek  according  to  the 
current  control  mode. 

1  is  the  length  of  the  array  in  bytesl 
Normal  return  is  zero . 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  integer  1  is  negative 
or  zero. 

SEE  ALSO: 

st  rout ( ) »  1 t  t  r  C  ) 
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db 1 w  i  d 


Jur.  10  1976 


db 1 w  i  d 


NAME: 

dblwio  -  change  double  width  flag 


SYNOPSIS: 

db 1 w i d ( x  ) 
i  n  t  x  ; 


DESCRIPTION: 


If  x  is 

eaual 

t  0 

zero  t 

the  doub 1 e 

width 

f  1  ag 

c  on  t  ro 1 

mode 

i  s 

set  to 

zero ,  i . e . 

turned 

off. 

If  x  is 

eaua  1 

t  o 

one  • 

the  douo 1 e 

width 

f  1  ag 

control 

mode 

i  s 

set  to 

one /  i . e . 

turned 

on  . 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassed  integer  x  i 
eaual  to  zero  or  one. 


SEE  ALSO: 

s  i  ze  ( ) 


n  the 

n  the 

s  not 
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erase 


Jun  10  1976 


erase 


NAME: 

erase  -  erases  the  screen 


SYNOPSIS: 

erase!) 


DESCRIPTION: 

The  ramtek  screen  is  erased  to  the  background  color  of 
the  color  table  currently  being  used. 
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f  i  xpt 


Jun  10  1976 


f  i  xpt 


NAME: 

f  i  x  p  t  -  change  fixed  point  flag  in  control  mode 


SYNOPSIS  : 

f i xpt ( x ) 
i  n  t  x  ; 


DESCRIPTION: 

If  x  is  eaual  to  zero*  the  fixed  point  flag  in  the 
control  mode  is  set  to  zero*  i.e.  turned  off. 

If  x  is  eaual  to  one*  the  fixed  ooi nt  flag  in  the  con¬ 
trol  mode  is  set  to  one*  i.e.  turned  on. 

Meaningful  only  in  Graphic  Vector  or  Graphic  Plot 
mode.  In  Graohic  Vector  mode  it  causes  all  subsequent 
vectors  to  be  drawn  with  one  end  at  the  same  point  as 
issued  by  a  subsequent  or  last  previous  strtxyO.  See 
the  user's  manual  for  fixptO's  meaning  in  Graohic 
Plot. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  integer  x  is  not 
equal  to  zero  or  one. 
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get  f 


Jun  tO  1976 


ge  t  f 


NAME 


getf  -  read  floating  ooint  number  from  ramtek  keyboard 


SYNOPSIS: 

ge  t  f  ( ) 


DESCRIPTION: 

Returns 
board, 
minus  s i 
c  o  n  t  a  i  n  i 
by  the  1 


a  floating  Doint  number  from  the  ramtek  key- 
The  only  numbers  recognized  are:  an  optional 
gn  followed  by  a  string  of  digits  optionally 
ng  one  decimal  point/  then  followed  optionally 
etter  'e'  followed  by  a  signed  integer. 


Normal 


return  is  the 


floating  do 


n  t  numbe  r . 


SEE  ALSO: 

aetnumC)/  retcharO 
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ge  t  num 


Jun  10  1976 


ge  t  num 


NAME : 

getnum  -  read  number  from  ramtek  keyboard 


SYNOPSIS: 

getnum(base) 
i nt  base  ? 


DESCRIPTION: 

Returns  a  positive  or  negative  integer  number  from  the 
ramtek  keyboard.  Numerals  tyoed  up  to  a  comma  or  a  c/r 
on  the  keyboard  are  consioered  to  be  the  number.  The 
routine  will  not  return  any  value  until  a  c/r  or  a 
comma  is  typed/  nor  will  it  accept  characters  other 
than  digits  from  zero  to  nine  when  base  is  equal  to 
ten,  or  digits  from  zero  to  seven  in  case  of  base 
eight  . 

base  is  the  base  of  the  integer  number  returned.  It 
is  restricted  to  eight  (octal)  or  ten  (decimal). 

Normal  return  is  the  integer  number. 


DIAGNOSTICS: 

All  errors  are  indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are  as  follows: 

-1  Indicates  a  c/r  was  struck  without  any  previous 
entries. 

-2  Indicates  the  passed  parameter  base  was  not  eaual 
to  eight  or  ten. 

SEE  ALSO: 

re  t  c h a  r  (  )  / 


ge  t  f  ( ) 


index 


Jun  10  1976 


index 


NAME: 

index  -  select  indexing 


SYNOPSIS: 

i  nde  x ( i  ,x,y) 
float  x /  y ; 
int  i  ; 


DESCRIPTION: 

If  i  equals  zero*  indexing  is  deselected  and  the  in¬ 
dexing  flag  in  the  control  mode  is  turned  off.  The 
index  registers  are  then  loaded  with  zero. 

/ 

If  i  eauals  one*  index i n a  is  selected  and  the  indexing 
flag  in  the  control  mode  is  turned  on.  The  index 
registers  are  then  loaded  with  the  displacements 
passed  in  x  and  y.  x  is  loaded  in  the  x-index  regis¬ 
ter  and  y  is  loaded  in  the  y-index  register. 

x  must  be  no  greater  than  the  user-defined  screen 
width.  y  must  be  no  greater  than  the  user-defined 
screen  height. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are  indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are  as  follows: 

-1  Indicates  the  passed  integer  i  is  not  eaual  to 
zero  or  one. 

-2  Indicates  one  of  the  passed  displacements  x  and  y 
is  greater  than  the  screen  height  or  width. 


SEE  ALSO: 

sc  reen  C  ) 
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NAME  : 

inter  -  interactive  color  table  modification  routine 


SYNOPSIS  : 

i  n  t  e  r  (  ) 


DESCRIPTION: 

Sets  up  and  runs  a  tutorial  program  that  enables  the 
user  to  look  at »  select  and  modify  color  tables  during 
program  execution.  There  are  two  basic  modes  in  which 
the  routine  operates.  Each  of  these  modes  has  a 
series  of  commands  which  the  user  can  execute. 

1.  Paginq  Mode.  Upon  execution  the  paging  mode  is 
immediately  entered  and  a  set  of  instructions  is 
displayed.  The  following  commands  are  then  accept¬ 
able: 


'p' 

-  Indicates  a  oarti 
displayed.  The 

between  zero  and 

cul ar  table  number  i 
number  must  then  be 
seven  t  een  . 

s  t  o  be 
entered 

•n  ' 

-  Increments 

table 

numbe  r  displayed 

by 

one  . 

•b  ' 

-  Decrements 

table 

numbe  r  displayed 

by 

one . 

'  i  ' 

-  Displays  i 

ns  t  rue  t 

ions. 

'q' 

-  Quits  from 

the  interactive  routine 

+ 

•e' 

-  Enters  the 

edit  mode  . 

2.  Edit  Mode.  When  the  edit  mode  is  entered/  a  set 
of  instructions  is  displayed  listing  the  commands  that 
can  be  issued  and  the  edit  method  they  initiate.  The 
commands  are: 

*  t '  -  Enters  table  assignment  method.  Permits 
entries  from  any  table  to  be  copied  into  the 
table  designated  by  the  user.  The  table 
number  which  is  to  receive  the  copied  en¬ 
tries  must  be  entered  first. 

'o'  -  Enters  octal  assignment  method.  Entries  are 
specified  in  a  designated  table  by  entering 
the  ordered  triple  that  defines  the  color 
desired.  The  table  number  (4-17)  in  which 
the  entries  are  to  be  defined  must  be  en- 
t  e  red  first. 

'  c  '  -  Enters  combining  assignment  method.  This 


76 


inter 


Jun  10  1976 


inter 


method  allows  the  user  to  logically  OR  two 
separate  color  lookup  table  entries  into  a 
selected  user  table  entry.  Whole  tables  may 
also  be  combined  into  a  selected  user  table. 
The  user  table  number  (4-17)  must  be  entered 
f  i  r  s  t  . 

'  f  '  -  Enters  inverting  tables  method.  This  method 
inverts  the  user  table  designated  by  the 
user.  Entry  zero  becomes  fifteen/  entry  one 
becomes  fourteen/  etc.  The  act  of  entering 
the  user  table  number  executes  the  inver¬ 
sion. 

'  m  '  -  Enters  copying  tables  method.  After  entry 

of  the  user  table  number  that  is  to  receive 
a  copied  table  the  number  of  the  table  to  be 
copied  is  entered.  The  act  of  entering  the 
second  table  number  causes  the  copy  to  take 
place. 

Upon  entry/  the  editing  methods  display  a  list  of 
instructions  on  how  the  method  is  to  be  used  and  the 
results  obtained.  Each  of  the  methods  have  commands 
that  may  be  issued.  .  The  legal  commands  for  each  edit 
method  are  summarized  below. 

-  Table  Assignment  Method. 

'n'  -  Indicates  the  table  number  and  entry 

to  be  copied  follows. 

'c/r'-Increments  through  the  entries 
in  the  receiving  user  table. 

'o'  -  Disolays  the  color  1 ookuo  table  be- 

modified.  To  return  from  the  dis¬ 
play/  type  a  'g'. 

'g'  -  Quits  back  to  edit  mode  instructions. 

-  Octal  Assignment  Method. 

'  n '  -  Indicates  the  octal  triple  to  be  en¬ 
tered  as  the  entry  follows. 
'c/r'-Increments  through  the  entries 
in  the  receiving  user  table. 

'o'  -  Displays  the  color  lookup  table  be¬ 

ing  modified.  To  return  from  the 
disDlay/  type  a  'o'. 

'g'  -  Quits  back  to  edit  mode  instructions. 
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-  Combining  Assignment  Method. 

'n'  -  Indicates  the  two  ordered  pairs 

designating  the  table  number  and 
entry  number  to  be  OP'a  are  to  fol¬ 
low. 

1  c / r ' - 1 nc r emen t s  through  the  entries  in 
the  receiving  user  table. 

'o'  -  Displays  the  color  lookup  table 

being  modified.  To  return  from 
the  display/  type  a  'o'. 

' w '  -  Indicates  two  whole  tables  are  to 
be  combined  (OR'd)  and  their  num¬ 
bers  are  to  follow. 

'  g  '  -  Quits  back  to  edit  mode  instructions 


-  Inverting  Tables  Method. 

Displays  the  color  lookup 
ng  or  was  inverted, 
back  to  edit  mode  instructions 


'P' 


table  that 


i  S 

be 

'q' 

-  Q  u 

i  t  s 

Copying 

Tab! 

es 

•p' 

-  Di 

sp  1 

'q' 

-  Qu 

i  t  s 

Method. 

avs  the  receiving  table, 
back  to  edit  mode  instructions 


78 


1  1 1  r 


Jun  10  1976 


1  t  t  r 


NAME  : 

lttr  -  display  single  character 


SYNOPSIS: 

lttr(chzsize) 
int  c  h  /  size; 


DESCRIPTION: 

Will  display  the  character  passed  with  the  size  indi¬ 
cated  at  the  current  operating  point. 

After  display/  the  current  operating  point  is  on  the 
same  line  and  seven  actual  screen  elements  to  the 
right  of  its  last  position. 

ch  contains  the  ascii  code  for  the  character  to  be 
displayed. 

If  size  is  eaual  to  one/  the  character  is  displayed  in 
standard  size. 

If  size  is  equal  to  two/  the  character  is  displayed  in 
doub le  width  size. 

The  operation  is  independent  of  any  mode  issued  previ¬ 
ously/  but  is  sensitive  to  the  flags  applicable  to 
Alphanumeric  mode. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  integer  size  was  not 
equal  to  one  or  two. 


SEE  ALSO: 

strout  ()  /  data!)/  sized/  index!)/ 
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NAME  : 

cloth  -  clot  data  as  a  histogram 


SYNOPSIS: 

oloth(x,y,n,base) 
float  *  x ,  *  y /  base? 
i  n  t  n  ? 


DESCRIPTION: 

The  values  ytil  are  assumed  to  be  functions  of  x(i]. 
As  the  function  is  clotted/  the  area  between  the  curve 
and  the  x-axis/  as  designated  by  base/  is  filled  in 
with  the  color  last  selected. 

That  oortion  of  the  histogram  that  lies  on  the  screen 
will  be  clotted. 

The  ooeration  is  totally  indecendent  of  any  control 
mode  issued  oreviously. 

x  and  y  are  oointers  to  linear  arrays, 
n  is  the  number  of  ooints  to  be  clotted. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are  indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are  as  follows: 

Returned  -1  indicates  the  gassed  oarameter  base  is  not 
on  the  user-defined  screen. 


SEE  ALSO: 

plotlnC)/  olotctO 
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NAME  : 

Plotln  -  plot  data  with  connected  lines 


SYNOPSIS: 

plotln(x,y,n) 
float  *  x  /  *y  ? 
i  n  t  n  ; 


DESCRIPTION: 

.  The  values  yCil  are  assumed  to  be  functions  of  x  t  i  ]  . 
As  the  function  is  plotted/  the  successive  points  are 


connected  by 
ed . 

straight  lines 

of  the  color 

last 

select- 

That  portion 

of  the  plotted 

curve  which 

lies 

on  the 

screen  will 

be  plotted. 

The  ooerat i on  is  totally  independent  of 

any 

control 

mode  issued  oreviously. 

x  and  y  are  pointers  to  linear  arrays, 
n  is  the  number  of  points  to  be  plotted. 


SEE  ALSO: 

p  1  o  t  h  (  )  »  plotPtH 
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NAME: 

plotpt  -  plot  data  with  points 


SYNOPSIS : 

plotpt (x  t y > n) 
float  *  x  f  *y ; 
i  n  t  n  ; 


DESCRIPTION: 

The  values  of  ytil  are  assumed  to  be  functions  of 
xti].  The  function  is  plotted  with  dots  for  each 
(x(i]*y[ij)  coordinate.  The  dots  are  the  color  last 
selected. 

If  a  point  does  not  lie  on  the  user-defined  screen?  it 
is  not  plotted. 

The  operation  is  totally  independent  of  any  control 
mode  issued  previously. 

x  and  y  are  pointers  to  linear  arrays, 
n  is  the  number  of  points  to  be  plotted. 


SEE  ALSO: 

oloth(),  plotlnO 
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NAME: 

point  -  define  point 


SYNOPSIS: 

po i nt ( x , y ) 

float  x ,  y  ; 


DESCRIPTION: 

Defines  a  point  on  the  user-defined  screen.  The  point 
must  lie  within  the  user-defined  screen. 

If  in  Graphic  Vector  m o  d  e »  (  x  ,  y  )  defines  the  endpoint 

of  a  vector  and  causes  it  to  be  drawn.  The  current 
operating  point  is  then  (x,y). 

If  in  the  Graphic  Element  mode>  (x» y)  defines  a  single 
point  on  the  user-defined  screen  and  causes  a  dot  to 
be  drawn  there.  The  current  ooerating  point  is  then 
(  x  ,  y  )  . 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  oassed  point  does  not  lie  on 
the  user-defined  screen. 


SEE  ALSO: 

s  t  r  t  x  y  (  ) 
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NAME: 

poi nt  r  -  define  a  point  relative 


SYNOPSIS: 

do i n  t  r ( x / y ) 
float  x  f  y  ? 


DESCRIPTION: 

Defines  a  ooint  on  the  user-defined  screen  relative  to 
the  last  current  operating  point. 

If  in  Graphic  Vector  mode  a  vector  from  the  last 
current  operating  ooint  to  a  ooint  defined  by  the  last 
current  operating  ooint  plus  the  displacements  x  and  y 
is  drawn. 

If  in  Graphic  Element  mode  a  dot  is  drawn  at  a  point 
defined  by  the  last  current  operating  ooint  plus  the 
displacements  x  and  y. 

The  COP  is  left  at  the  calculated  location. 


SEE  ALSO: 

s  t  r  t  x  y  (  ) 
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NAME: 

ramtek  -  initiates  ramtek  system 


SYNOPSIS: 

ramtek ( ) 


DESCRIPTION: 

Initiates  the  ramtek  system  ana  sets  the  default  con¬ 
ditions  as  follows: 

1  -  Initialize  the  user-defined  screen  to  0.0  to 

100.0  in  x  and  y. 

2  -  Loads  a  shades  of  grey  color  table  (0)  in  the 

ramtek. 

3  -  Selects  color  fifteen  in  table  zero  for  display. 

4  -  Selects  AlDhanumeric  control  mode. 

5  -  Opens  the  ramtek  for  readina  and  writing. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  i n a i cates  ramtek  device  could  not  be 
opened . 
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NAME: 

retchar  -  read  a  character 

from  ramtek  keyboard 

SYNOPSIS: 

r  e  t  c  h  a  r  (  ) 

DESCRIPTION: 

An  ascii  code  represent inq  the  typed  character  is 


returned  in  the  lower  half 

of  an  integer. 

SEE  ALSO: 

getnumO,  ge  t  f  ( ) 

86 


screen 


Jun  10  1976 


screen 


NAME: 

screen  -  define  user  screen 


SYNOPSIS: 

screen(xl,yl,x2,y2) 
float  x 1 »  y  1  ,  x  2  >  y 2  / 


DESCRIPTION: 

Defines  a  standard  cartesian  coordinate  system  of  any 
scale  for  the  user.  The  point  (xl,yl)  becomes  the 
coordinate  of  the  lower  left  corner  of  the  screen. 
The  point  (x2*y2)  becomes  the  coordinate  of  the  upper 
right  corner  of  the  screen. 

xl  must  be  strictly  less  than  x2. 

yl  must  be  strictly  less  than  y2. 

All  subsequent  user  coordinates  are  interpreted  a  c  - 
cording  to  this  user-defined  screen. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  xl  is  not  less  than  x2  or  yl  is 
not  less  than  y2.  An  error  message  is  also  printed  on 
the  terminal  screen. 
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NAME  : 

scroll  -  scroll  screen 


SYNOPSIS : 

scrol 1 (a»cnt) 
char  a; 
float  cnt  J 


DESCRIPTION: 

The  current  displayed  picture  on  the  screen  is 
scrolled  up  or  down.  Information  scrolled  off  the  top 
of  the  screen  will  be  scrolled  in  the  bottom  and 
v i ce*versa . 

If  a  is  the  character  '  d  '  /  the  direction  of  the  scroll 
will  be  down . 

If  a  is  the  character  '  u  '  >  the  direction  of  the  scroll 
will  be  up . 

cnt  is  the  number  of  user-defined  y-units  that  the 
picture  is  to  be  scrolled.  cnt  can  be  no  larger  than 
the  sc  reen  height. 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are  indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are  as  follows: 

-1  Indicates  the  passed  parameter  cnt  was  less  than 
zero  or  greater  than  the  screen  height. 

-2  Indicates  the  passed  parameter  c  was  not  a  ’ d '  or 
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NAME : 

setmode  -  select  control  mode 


SYNOPSIS: 

setmode(azb) 
int  a /  b » 


DESCRIPTION: 

Selects  the  control  mode  according  to  the  passed 
parameters  a  and  b.  a  represents  the  control  mode  as 
f o 1  lows: 

0  -  Alphanumeric 

1  -  Transverse  Data 

2  -  Raster  Data 

3  '  -  Como  lex  Data 

4  -  Graphic  Vector 

5  -  Graphic  Plot 

6  -  Graphic  Cartesian 

7  -  Graphic  Element 

All  flags  are  turned  off  if  b  is  eaual  to  zero.  If  b 
is  equal  to  one#  any  flags  set  in  the  previous  mode 
are  also  set  with  the  mode  selected  by  a.  All  enti¬ 
ties  displayed  suoseauent  to  this  call  are  displayed 
according  to  the  selected  mode.  Routines  that  disre¬ 
gard  the  selected  -node  are  axis!)/  block!)/  inter!)  » 
lttr!)/  olothO;  plotlnC),  plotptC)  and  vector!). 

Normal  return  is  zero. 


DIAGNOSTICS: 

All  errors  are  indicated  by  negative  returned  values. 
The  error  values  and  their  meanings  are  as  follows: 

-l  Indicates  the  passed  parameter  a  was  less  than 
zero  or  greater  than  seven. 

-2  Indicates  the  passed  parameter  b  was  not  equal  to 
zero  or  one . 

SEE  ALSO: 

ram t  e k  ! )  /  bkrnd! )  ^  db 1 w i d  (  )  /  fixptO/  index!)/ 
w  r i ton!) 
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NAME: 

size  -  select  letter  size 


SYNOPSIS: 

s i ze ( r  ) 
i  n  t  r  ; 


DESCRIPTION: 

If  r  is  equal  to  one  the  standard  character  si 
used. 

If  r  is  eaual  to  two  the  double  width  character 
is  used . 

Sets  the  double  width  flag  in  the  control 
Therefore  size  takes  the  same  action  as  dblwidO 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  parameter  r  i 
equal  to  one  or  two. 


SEE  ALSO: 

db  1  w  i  d  (  )  /  stroutOf  lttr() 


s  i  ze 


ze  i  s 

size 

mode . 


s  not 
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NAME: 

strout  -  output  character  string 


SYNOPSIS: 

strout ( sd ) 
char  * sp ? 


DESCRIPTION: 

Outputs  a  character  string  no  greater  than  100  charac¬ 
ters  Iona  beginning  at  the  current  operating  point  and 
continuing  on  the  same  line.  After  completion,  an 
automatic  line  feed  occurs  which  defines  a  new  current 
operating  point  on  the  next  line  at  the  same  starting 
point  as  the  previous  line. 

sp  points  to  the  character  string  to  be  output. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  string  contained  more  than 
100  characters.  In  this  case  no  characters  will  be 
di spl ayed. 


SEE  ALSO: 

dataO/  s  i  z  e  ( )  /  IttrO 
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NAME: 

strtxy  -  establish  current  operating  point 

SYNOPSIS: 

Strtxy(x»y) 
float  x ,  y ; 


DESCRIPTION: 

Establishes  the  current  operating  point  on  the  screen 
for  subseauent  instructions.  If  the  current  mode  is 
Graphic  Vector  with  the  fixed  point  flag  set  »  it  es¬ 
tablishes  the  base  from  which  the  vectors  are  drawn. 

x  is  auser-defined  screen  location  in  x.  y  is  a 
user-defined  screen  location  in  y. 

(x,y)  must  lie  within  the  user-defined  screen. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  (x,y)  does  not  lie  on  the  user- 
defined  screen. 


SEE  ALSO: 

fixptO,  screen!),  point!) 
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NAME: 

tblwho  -  request  for  current  color  table  number 


SYNOPSIS: 

t  b 1  who ( ) 


DESCRIPTION: 

Returns  an  integer  value  which  is  the  table  number  of 
the  color  table  that  is  currently  being  used  for 
display. 
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NAME  : 

triple  -  code  color  from  three  number  triple 


SYNOPSIS: 

triple(brg/r) 
i  n  t  b  f  g  9  r  ; 

DESCRIPTION: 

The  three  input  parameters  representing  the  amounts  of 
blue(b)#  green (g)  and  red(r)  are  coded  into  an  integer 
which  is  suitable  for  insertion  into  color  table  en¬ 
tries. 

b  is  between  0  and  15  and  represents  the  amount  of 
blue  desired. 

g  is  between  0  and  15  and  represents  the  amount  of 
green  desired. 

r  is  between  0  and  15  and  represents  the  amount  of  red 
des i red . 

Normal  return  is  an  integer  representing  the  code. 


DIAGNOSTICS: 

Returned  -1  indicates  input 
negative  or  greater  than  15. 


Parameters  b  > 


g  or  r  are 


SEE  ALSO: 

chngeO,  clrtblC) 
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NAME  : 

vector  -  draw  single  vector 


SYNOPSIS: 

vector(xl,yl/x2>y2) 
float  xlr  yl /  x2/  y 2  ? 


DESCRIPTION: 

A  vector  is  drawn  on  the  screen  from  user-defined 
screen  coordinate  Cxl/yl)  to  (x2»y2).  The  current 
operating  ooint  is  left  at  (x2/y2). 

The  operation  is  independent  of  any  mode  issued  previ¬ 
ously  but  is  sensitive  to  the  flags  applicable  to  the 
Graphic  Vector  control  mode.  Undesired  results  may  be 
obtained  if  the  fixot  flaq  is  set  previous  to  calling 
vector!)  . 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  no  portion  of  the  indicated  line 
lies  on  the  user  defined  screen. 


SEE  ALSO: 

bkrnd()»  dblwid,  fixotC)/  index!) 
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NAME: 

wri ton  -  additive  write 

SYNOPSIS: 

wri ton(w) 
i  n  t  w  ; 


DESCRIPTION: 

If  wise  one/  the  additive  write  flag  in  the  control 
mode  is  turned  on  causing  'subseauent  entities  in 
Alphanumeric,  Raster  Data  and  Transverse  Data  modes  to 
write  on  too  of  previous  entities  without  destroying 
them* 

If  w  is  a  zero,  the  additive  write  flag  in  the  control 
mode  is  turned  off. 

Normal  return  is  zero. 


DIAGNOSTICS: 

Returned  -1  indicates  the  passed  integer  w  is  negative 
or  greater  than  one. 
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